> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qredence.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring and diagnostics

> Check the daemon, the kernel, and running sessions. Fleet Prime Agent is local-first — no dashboards, just commands and logs.

Fleet Prime Agent runs on your machine and gives you a small set of commands to inspect what it's doing. No external dashboards, no distributed tracing.

## Everyday commands

| Command                        | Purpose                                            |
| ------------------------------ | -------------------------------------------------- |
| `prime-agent status`           | Daemon, kernel, and current-session summary.       |
| `prime-agent ps`               | List recent sessions.                              |
| `prime-agent agents`           | List running subagents.                            |
| `prime-agent attach <session>` | Attach an interactive client to a running session. |
| `prime-agent doctor`           | Full diagnostic; reports what's broken.            |
| `prime-agent doctor --fix`     | Same, but repairs what it can.                     |
| `prime-agent shutdown`         | Stop the daemon cleanly.                           |

## Logs

`~/.prime/agent/logs/`. One rotating file per component (daemon, kernel, web). Tail them when a run misbehaves; the log lines line up with the tool cards you saw in the UI.

## Web health

The web app exposes `GET /api/health` (`web/app/src/routes/api/health.ts`) which reports kernel readiness via `useKernelHealth`. Use it as a liveness probe if you run the web server under a supervisor.

## Telemetry

Opt-in only. When enabled, `packages/coding-agent/src/core/telemetry.ts` batches events into `telemetry.json` under the config dir. Nothing leaves the machine unless you explicitly wire an exporter.

## When to reach for `/doctor`

* The CLI hangs on startup.
* A session won't attach.
* IPython cells fail with a kernel error.
* After an upgrade.

`/doctor --fix` is the safe first move — it inspects the daemon socket, the kernel venv, and the auth store, and rebuilds what's rebuildable.