Collect diagnostics safely
What to gather, and what to strip before sharing it anywhere.
Written By Dustin
Last updated 16 minutes ago
Read this before pasting anything into a board, a ticket, or a chat. The feedback boards are public and third-party hosted.
What is safe and useful
- The
TVO-AREA-NNNcode — the single most useful thing, and it reveals nothing about your repository. tovio --version(the version flag; there is notovio versionsubcommand).- Your operating system and version.
- Which surface: CLI, VS Code, JetBrains, Desktop, SDK, MCP.
- A description of what you did and what happened.
What to strip
- File paths and repository names. Replace with
<path>. Paths are metadata and often disclose more than the content would. - Diffs and file contents.
- Tokens, keys, session strings, recovery phrases. Ever, on any channel.
- Identities, DIDs, hostnames, and other people’s data.
- The
contextblock of a--jsonerror. It is built for your eyes and routinely names paths, policy ids, identities, and attributes.
Getting just the code
Rather than pasting a whole error, pull out the one field that is safe to share:
tovio <command> --jsonReport error.code and error.exit_code. Leave title, cause, and context out — all three quote your repository back at you.
The rule of thumb
Describe the behaviour rather than pasting the evidence. If you cannot describe the problem without pasting one of the above, treat it as potentially security-sensitive and use security@tovio.dev instead of a public board.
Local diagnosis
tovio healthtovio fscktovio access check <path>Run these locally and report the conclusion, not the raw output. "fsck reports two corrupt objects" is a useful report; the output itself is not.