Check your setup

Agent status

One line for each agent that the doctor finds:

Line	Meaning	What to do
`<Agent>: healthy`	Wired and paired. Alike accepts the credential	Nothing
`<Agent>: detected but not wired — re-run`	The agent is on the machine, but Alike is not in its settings	Run `npx @alikeai/setup`
`<Agent>: wired, not yet paired — re-run to pair`	The machine is not paired	The doctor starts pairing. Approve the code
`<Agent>: token rejected (401) — re-pair`	Alike refused the machine’s credential	The doctor starts pairing. Approve the code
`<Agent>: server unreachable`	The doctor could not reach Alike	Check your network. See Troubleshooting
`runtime shim missing — re-run to reinstall`	The local runtime in `~/.alike/runtime` is gone	Run `npx @alikeai/setup`

Hook activity

For each wired agent, the doctor shows if its hooks ran on this machine:

firing (N hook runs, last <time>): the hooks work.
wired, but its hooks have NEVER fired — check the harness is restarted and hooks are enabled: the agent did not run the hooks yet. See Hooks never run.

For Codex, the doctor also reminds you to approve the Hooks need review prompt.

Connection test

The doctor sends two test events to Alike. The line starts with Telemetry round-trip:.

Result	Meaning
`server accepted 2 events`	The connection works
`the Builder loop is turned off in your Alike preferences — nothing is being recorded`	Your Alike account is set to not record agent sessions. You cannot change this setting in the web app. Contact support@alike.work
`credentials rejected — re-pair with ...`	Pair again
`server accepted <n> of 2 events`	Alike accepted only some test events. Run the doctor again
`not paired yet`	The machine is not paired. The doctor starts pairing
`endpoint unreachable`	Network problem
`endpoint returned HTTP <code>`	Alike returned an error. Try again later

Capture coverage

For each agent that you chose for transcript capture:

N session(s) found: the doctor found this many session files.
detected but 0 sessions found in <folder> — capture may be misconfigured: the agent is installed, but the doctor found no history in the expected folder. The agent may keep history in a different place on your version. Tell support@alike.work.
capture disabled (not selected at install): you did not choose this agent for capture.

Sweep health

A sweep copies new transcripts and uploads them. The doctor shows:

How long ago the last sweep ran, and counts for each agent.
N of M archived session(s) never uploaded to this server: some sessions are copied on the machine but not uploaded yet.
N session(s) permanently rejected by the server — see ~/.alike/logs/sweep.log: Alike refused these sessions, for example because a session is too large. They are not sent again.
no sweep has completed on this machine yet — run `npx @alikeai/setup --sweep` : no sweep ran yet.

What the doctor checks