Troubleshooting
When a test fails or a command stops, hand the result to your agent. discerndiscernA tool that lets you hand real work to coding agents and still decide what joins your project.'s results say what's true now and what to do next, so your agent can find the cause and recover by itself. These pages show which decisions stay yours.
"Explain this result, fix what you can, and bring me any decision that changes what we agreed to build or check."
Find the symptom
§| What you see | Where to go |
|---|---|
| Setup stopped, or a coding tool can't reach discern. | Setup and integrations |
| A build, test, or other project check failed. | Fix a red gate |
| The gateGateThe full set of checks your project requires before a change counts as finished. won't run, or passes without Proof you can use. | Gate and Proof |
| A standardStandardA measured limit your project holds, such as a maximum download size or a minimum test coverage. or checkpointCheckpointA review question your project asks your agent whenever a certain kind of change happens. needs attention. | Gate and Proof |
| A task's workspace, resources, or cleanup look wrong. | Worktrees and resources |
| A session ended before the task finished. | Recover an interrupted task |
| discern's tools disappeared, a call or wait ended early, or a page won't open. | MCP, terminal, and docs |
| discern crashed, or you found local files you don't recognize. | Crashes and local state |
| You want to upgrade or remove discern. | Maintain or remove discern |
Help your agent find the cause
§Keep the original result. It names the failing command, where the full output is, and how to reproduce the problem, so your agent starts there instead of rerunning everything. For an install problem, your agent runs discern doctor, which checks the installation and changes nothing.
Recovery is done when the tool connects, the command finishes, or the repaired change has fresh Proof, discern's record of which commands passed on its exact commit.
When the next step needs you
§Loosening a limit or removing a check changes what later work must meet, so it's your decision. So is landing despite an unmet review question, and so is cleanup that throws work away. Ask your agent for the evidence, the options, and its recommendation.
If a page's recovery still fails, keep the result as evidence and report the problem.
In this section
§- Setup and integrationsFinish installing discern, carry on with a setup that stopped partway, and get your coding agent connected.
- Gate and ProofFind out why the gate stopped or gave no Proof, fix the cause, and know which decisions are yours.
- Worktrees and resourcesFind out why a task won't land or won't clean up, or why its app uses the wrong settings, and fix it without losing work.
- MCP, terminal, and docsGet your agent's discern tools back, keep a wait going, read a result you missed, and open the page you need, without running anything twice.
- Crashes and local statePick up your task after discern crashes, send a useful report, and find out what a discern file holds before you delete it.