{
  "id": "page:docs-user-guide-getting-started-upgrade-to-v6",
  "_kind": "Page",
  "_file": "wiki/docs/user-guide/getting-started/upgrade-to-v6.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/user-guide/getting-started/upgrade-to-v6.md",
    "sourceKind": "repo-docs",
    "title": "Upgrade to v6: Uninstall Prod & Reinstall on Any Harness",
    "displayName": "Upgrade to v6: Uninstall Prod & Reinstall on Any Harness",
    "slug": "docs/user-guide/getting-started/upgrade-to-v6",
    "articlePath": "wiki/docs/user-guide/getting-started/upgrade-to-v6.md",
    "article": "\n[Docs](../index.md) › [Getting Started](./README.md) › Upgrade to v6\n\n# Upgrade to v6: Uninstall Prod & Reinstall on Any Harness\n\n**Category:** Getting Started · **Last Updated:** 2026-06-25\n\n## On this page\n\n- [In Plain English](#in-plain-english)\n- [Step 1 — Uninstall the prod babysitter](#step-1--uninstall-the-prod-babysitter)\n- [Step 2 — Install v6 (harness-neutral first)](#step-2--install-v6-harness-neutral-first)\n- [Step 3 — Per-harness install (all major harnesses)](#step-3--per-harness-install-all-major-harnesses)\n- [Step 4 — Verify](#step-4--verify)\n- [Rollback](#rollback)\n- [Related Documentation](#related-documentation)\n- [Next steps](#next-steps)\n\n---\n\n## In Plain English\n\n**v6 is a deliberate semver-major jump: the prod `0.0.x` series (last release `0.0.175`) becomes v6, shipped as `5.x` packages.** The primary install package changed from `@a5c-ai/babysitter-sdk` to `@a5c-ai/babysitter`, and Babysitter is now harness-agnostic instead of Claude-only. This page is the hands-on uninstall-and-reinstall runbook; for the full list of breaking changes and what each one means, read the conceptual [Migration Guide](./migration.md) first.\n\n---\n\n## Step 1 — Uninstall the prod babysitter\n\nRemove the prod toolchain before installing v6. These steps are grounded in the [Migration Guide](./migration.md); skip any that do not apply to your machine.\n\nRemove the old prod global CLI/SDK:\n\n```bash\nnpm rm -g @a5c-ai/babysitter-sdk\n```\n\nRemove any old per-harness plugin you installed under prod. For Claude Code:\n\n```bash\nclaude plugin uninstall babysitter@a5c.ai\n```\n\n> For any other harness, use that harness's normal plugin-uninstall command — prod uninstall commands for non-Claude harnesses are not in the source-of-truth context, so do not guess.\n\nRemove the global hooks adapter CLI if it is present:\n\n```bash\nnpm rm -g @a5c-ai/hooks-adapter-cli\n```\n\nIf the `babysitter` command is on your PATH but broken (for example it exits with `MODULE_NOT_FOUND` from a stale global shim), clear both global packages so v6 can install cleanly:\n\n```bash\nnpm rm -g @a5c-ai/babysitter @a5c-ai/babysitter-sdk\n```\n\nDrop the deprecated/removed environment variables from your shell profile and scripts:\n\n- `BABYSITTER_SESSION_ID` (renamed to `AGENT_SESSION_ID` in v6)\n- `CLAUDE_SESSION_ID` (now the harness-agnostic `AGENT_SESSION_ID`)\n- `CLAUDE_PLUGIN_ROOT` (removed in v6 — the runtime injects `BABYSITTER_PLUGIN_ROOT` into hooks; you do not set it)\n\nRemove the dropped `--plugin-root` flag from any command or script — it is removed in v6, and plugin/root resolution is now handled by the harness-agnostic runtime.\n\nFinally, note the directory rename: prod's `plugins/` directory is `blueprints/` in v6 (and `plugin:*` commands become `blueprints:*`, with the `plugin:*` aliases retained for one release and marked deprecated). Update any paths and scripts that referenced `plugins/`.\n\n---\n\n## Step 2 — Install v6 (harness-neutral first)\n\nLead with the universal, harness-neutral path. This works for **every** supported harness.\n\nFirst install the core CLI:\n\n```bash\nnpm install -g @a5c-ai/babysitter\n```\n\nThen install your harness's plugin with the universal SDK helper — the argument is the **harness key** (which may differ from the harness name):\n\n```bash\nbabysitter harness:install-plugin <harness-key> [--workspace <path>]\n```\n\nAlso install the new host-side Adapters CLI (per the [Migration Guide](./migration.md)):\n\n```bash\nnpm install -g @a5c-ai/adapters-cli\n```\n\nThat is the complete neutral path: core CLI, the per-harness plugin via `babysitter harness:install-plugin <harness-key>`, and the Adapters CLI. Step 3 lists the exact harness keys and any harness-native installers.\n\n---\n\n## Step 3 — Per-harness install (all major harnesses)\n\nEvery harness shares the neutral helper from Step 2. Some harnesses also offer a marketplace or `npx` installer; those are shown only where the [Install Matrix](../harnesses/install-matrix.md) lists them. For depth (invocation token, hook/continuation model), follow the linked pages rather than duplicating everything here.\n\n**Claude Code** and **Codex** are the two most mature, fully-worked harnesses — start with these if you have a choice. They each have their own page: [Claude Code](../harnesses/claude-code.md) and [Codex](../harnesses/codex.md).\n\n| Harness | Harness key | Marketplace / native installer? |\n|---------|-------------|---------------------------------|\n| Claude Code (most proven) | `claude-code` | Yes — see below |\n| Codex (most proven) | `codex` | Neutral helper |\n| Antigravity | `antigravity-cli` | No marketplace — neutral helper only |\n| Cursor | `cursor` | Yes (npx) — see below |\n| Gemini | `gemini-cli` | No marketplace — neutral helper only |\n| GitHub Copilot | `github-copilot` | Yes — see below |\n| Hermes | `hermes` | Neutral helper |\n| oh-my-pi | `oh-my-pi` | Yes (npx / omp) — see below |\n| openclaw | `openclaw` | Yes (npx) — see below |\n| opencode | `opencode` | Yes (npx) — see below |\n| Pi | `pi` | Yes (npx / pi) — see below |\n| genty | `genty` | Yes (npx) — see below |\n\n### Claude Code (most proven)\n\n```bash\nclaude plugin marketplace add a5c-ai/babysitter-claude\nclaude plugin install --scope user babysitter@a5c.ai\nclaude plugin enable --scope user babysitter@a5c.ai\n```\n\nRestart Claude Code after installing. Depth: [Claude Code](../harnesses/claude-code.md).\n\n### Codex (most proven)\n\n    babysitter harness:install-plugin codex [--workspace <path>]\n\n    # Marketplace path\n    codex plugin marketplace add a5c-ai/babysitter --ref <released-tag> --sparse .agents/plugins\n    codex plugin list --marketplace babysitter\n    codex plugin add babysitter --marketplace babysitter\n\n    # Alternative (npx installer)\n    npx --yes @a5c-ai/babysitter-codex install --global\n    npx --yes @a5c-ai/babysitter-codex install --workspace <path>\n\nDepth: [Codex](../harnesses/codex.md).\n\n### Antigravity\n\nNeutral helper only — there is no standalone npm installer for this harness.\n\n```bash\nbabysitter harness:install-plugin antigravity-cli [--workspace <path>]\n```\n\n### Cursor\n\n```bash\nbabysitter harness:install-plugin cursor [--workspace <path>]\nnpx --yes @a5c-ai/babysitter-cursor install --global\nnpx --yes @a5c-ai/babysitter-cursor install --workspace <path>\n```\n\n> Cursor's marketplace add is UI-only (via the bundled marketplace manifest); there is no CLI `marketplace add` for Cursor.\n\n### Gemini\n\nNeutral helper only — there is no standalone npm installer for this harness.\n\n```bash\nbabysitter harness:install-plugin gemini-cli [--workspace <path>]\n```\n\n### GitHub Copilot\n\n```bash\nbabysitter harness:install-plugin github-copilot [--workspace <path>]\ncopilot plugin marketplace add a5c-ai/babysitter-github-copilot && copilot plugin install babysitter\ncopilot plugin install a5c-ai/babysitter-github-copilot\nbabysitter-github install --cloud-agent --workspace <path>\n```\n\n### Hermes\n\n```bash\nbabysitter harness:install-plugin hermes [--workspace <path>]\n```\n\n### oh-my-pi\n\n```bash\nbabysitter harness:install-plugin oh-my-pi [--workspace <path>]\nnpx --yes @a5c-ai/babysitter-omp install --global\nnpx --yes @a5c-ai/babysitter-omp install --workspace <path>\nomp plugin install @a5c-ai/babysitter-omp\n```\n\n### openclaw\n\n```bash\nbabysitter harness:install-plugin openclaw [--workspace <path>]\nnpx --yes @a5c-ai/babysitter-openclaw install --global\nnpx --yes @a5c-ai/babysitter-openclaw install --workspace <path>\n```\n\n### opencode\n\n```bash\nbabysitter harness:install-plugin opencode [--workspace <path>]\nnpx --yes @a5c-ai/babysitter-opencode install --global\nnpx --yes @a5c-ai/babysitter-opencode install --workspace <path>\nnpx --yes @a5c-ai/babysitter-opencode install --accomplish\n```\n\n### Pi\n\n```bash\nbabysitter harness:install-plugin pi [--workspace <path>]\nnpx --yes @a5c-ai/babysitter-pi install --global\nnpx --yes @a5c-ai/babysitter-pi install --workspace <path>\npi install npm:@a5c-ai/babysitter-pi\npi install -l npm:@a5c-ai/babysitter-pi\n```\n\n> On Pi, `/resume` is reserved by the harness, so use `/babysitter:resume`.\n\n### genty\n\nInstall via the SDK helper or the npm-only installer:\n\n    babysitter harness:install-plugin genty [--workspace <path>]\n    npx --yes @a5c-ai/babysitter-genty install --global\n    npx --yes @a5c-ai/babysitter-genty install --workspace <path>\n\nFor the full per-harness reference (invocation tokens and hook/continuation models), see the [Install Matrix](../harnesses/install-matrix.md).\n\n---\n\n## Step 4 — Verify\n\nRun the v6 verification checks from the [Migration Guide](./migration.md) checklist.\n\nCheck the host-side Adapters CLI health:\n\n```bash\nadapters doctor\n```\n\nRun a smoke test against an installed harness:\n\n```bash\nadapters run claude \"say hi\"\n```\n\nConfirm the core CLI is on the v6 line (expect a `5.x` version, `5.1.0` for this edition):\n\n```bash\nbabysitter --version\n```\n\nFinally, re-run a known process to confirm your workflows still behave as expected.\n\n---\n\n## Rollback\n\nIf you need to return to the prod `0.0.x` series, reinstall the prod global CLI/SDK at the last prod release:\n\n```bash\nnpm install -g @a5c-ai/babysitter-sdk@0.0.175\n```\n\nThen reinstall your old harness plugin (for Claude Code, re-add the marketplace and install the plugin as you did under prod).\n\n> **State / journal caveat:** v6 is a deliberate semver-major jump with breaking changes (renamed packages, removed `--plugin-root`, `BABYSITTER_SESSION_ID` → `AGENT_SESSION_ID`, and `plugins/` → `blueprints/`). Runs created or migrated under v6 are not guaranteed to be readable or resumable by the prod `0.0.x` toolchain. Roll back on a clean working tree and expect to re-run, not resume, any in-flight work.\n\n---\n\n## Related Documentation\n\n- [Migration Guide](./migration.md) — the full breaking-changes list\n- [Installation](./installation.md) — the standard v6 install guide\n- [Install Matrix](../harnesses/install-matrix.md) — every harness key, install command, and hook model\n- [Adapters](../features/adapters.md) — why Babysitter is harness-agnostic\n- [Hooks](../features/hooks.md) — per-harness continuation models\n\n---\n\n## Next steps\n\n- **Next:** [Quickstart](./quickstart.md) — run your first v6 workflow\n- **Related:** [Migration Guide](./migration.md) · [Installation](./installation.md)\n- **Related:** [Install Matrix](../harnesses/install-matrix.md) · [Adapters CLI](../reference/adapters-cli.md)\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-user-guide-getting-started",
      "to": "page:docs-user-guide-getting-started-upgrade-to-v6",
      "kind": "contains_page"
    }
  ]
}