{"version":"2.1.224","anchor":"self-hosted-runner-setup-and-doctor-walk-you-through-it-in-a","canonical_anchor":"self-hosted-runner-setup-and-doctor-walk-you-through-it-in-a","heading":"self-hosted-runner setup and doctor walk you through it in a scoped Claude session","tier":"use","area":"Self-Hosted Runner","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.224\/e\/self-hosted-runner-setup-and-doctor-walk-you-through-it-in-a","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.224","markdown":"### `self-hosted-runner setup` and `doctor` walk you through it in a scoped Claude session\n\nsetup and doctor relaunch Claude with a restricted toolset to walk you through runner install and diagnostics.\n\n**What**\n\nTwo new subcommands re-launch Claude with a fixed system prompt and a restricted tool allowlist to guide an operator interactively. `setup` goes from creating an environment in the Admin UI to a live runner and writes `.\/runner-setup\/CHEAT-SHEET.md`. `doctor` works through nine diagnostic categories one step at a time and produces a redacted tarball you can attach to a support escalation.\n\n**Details**\n\n- Both run with `--permission-mode default` and tools limited to Bash, Read, Write, Todo and Task plus the typed runner admin tools.\n- `doctor` additionally gets tools to list sessions and requeue a session; `setup` gets the tool that spawns a local runner.\n- Outcomes are recorded under telemetry names `cli_self_hosted_setup` and `cli_self_hosted_doctor`, including `spawn_failed`, `child_signal` and `child_nonzero`.\n\n**Evidence**\n\n`Start the self-hosted runner doctor wizard. Greet me, then ask me to describe the symptom or pick from the 8 diagnostic categories. Work through it one step at a time.`\n\n- Area: Self-Hosted Runner\n- Names: `self-hosted-runner setup`, `self-hosted-runner doctor`\n- Tier: Use it now\n- Useful: 3\/5\n- Signal: 4\/5"}