Check your install | TaloTrace Documentation

`talotrace doctor`

talotrace doctor --ports 3000

doctor only reads. It never opens a browser and changes nothing. Each failing check names one next step. It exits 1 when a check fails.

Check	What it tells you
Profile	Which environment this CLI follows.
Build	The version of the CLI.
Keychain	Whether the operating system keychain answers. If not, use an API key.
App and ports	Whether your app listens on the ports you gave with `--ports`.
Agents	A warning when a coding agent has no TaloTrace skill or MCP entry, or its MCP entry pins another CLI version. It never fails. Run `talotrace setup` to fix it.
Server	Whether TaloTrace can be reached.
Protocol	Whether this CLI is new enough. If not, upgrade it.
Access	Whether the stored sign-in works for one real call.

--offline skips the checks that need the network. --timeout bounds one request.

The `diagnose` tool

Your agent calls diagnose first, and again whenever a call is refused. It answers ready, degraded or blocked for a project and lists next_steps. A step marked run is a call the agent makes. A step marked guidance is for you: the agent shows it word for word.

See MCP tools for the full answer.

If you are stuck, open Troubleshooting.