Docs › Getting Started › Upgrade to v6

Upgrade to v6: Uninstall Prod & Reinstall on Any Harness

**Category:** Getting Started · **Last Updated:** 2026-06-25

On this page

• In Plain English
• Step 1 — Uninstall the prod babysitter
• Step 2 — Install v6 (harness-neutral first)
• Step 3 — Per-harness install (all major harnesses)
• Step 4 — Verify
• Rollback
• Related Documentation
• Next steps

---

In Plain English

**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 first.

---

Step 1 — Uninstall the prod babysitter

Remove the prod toolchain before installing v6. These steps are grounded in the Migration Guide; skip any that do not apply to your machine.

Remove the old prod global CLI/SDK:

npm rm -g @a5c-ai/babysitter-sdk

Remove any old per-harness plugin you installed under prod. For Claude Code:

claude plugin uninstall babysitter@a5c.ai

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.

Remove the global hooks adapter CLI if it is present:

npm rm -g @a5c-ai/hooks-adapter-cli

If 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:

npm rm -g @a5c-ai/babysitter @a5c-ai/babysitter-sdk

Drop the deprecated/removed environment variables from your shell profile and scripts:

• BABYSITTER_SESSION_ID (renamed to AGENT_SESSION_ID in v6)
• CLAUDE_SESSION_ID (now the harness-agnostic AGENT_SESSION_ID)
• CLAUDE_PLUGIN_ROOT (removed in v6 — the runtime injects BABYSITTER_PLUGIN_ROOT into hooks; you do not set it)

Remove 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.

Finally, 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/.

---

Step 2 — Install v6 (harness-neutral first)

Lead with the universal, harness-neutral path. This works for **every** supported harness.

First install the core CLI:

npm install -g @a5c-ai/babysitter

Then install your harness's plugin with the universal SDK helper — the argument is the **harness key** (which may differ from the harness name):

babysitter harness:install-plugin <harness-key> [--workspace <path>]

Also install the new host-side Adapters CLI (per the Migration Guide):

npm install -g @a5c-ai/adapters-cli

That 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.

---

Step 3 — Per-harness install (all major harnesses)

Every 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 lists them. For depth (invocation token, hook/continuation model), follow the linked pages rather than duplicating everything here.

**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 and Codex.

Claude Code (most proven)

claude plugin marketplace add a5c-ai/babysitter-claude
claude plugin install --scope user babysitter@a5c.ai
claude plugin enable --scope user babysitter@a5c.ai

Restart Claude Code after installing. Depth: Claude Code.

Codex (most proven)

babysitter harness:install-plugin codex [--workspace <path>]

# Marketplace path codex plugin marketplace add a5c-ai/babysitter --ref <released-tag> --sparse .agents/plugins codex plugin list --marketplace babysitter codex plugin add babysitter --marketplace babysitter

# Alternative (npx installer) npx --yes @a5c-ai/babysitter-codex install --global npx --yes @a5c-ai/babysitter-codex install --workspace <path>

Depth: Codex.

Antigravity

Neutral helper only — there is no standalone npm installer for this harness.

babysitter harness:install-plugin antigravity-cli [--workspace <path>]

Cursor

babysitter harness:install-plugin cursor [--workspace <path>]
npx --yes @a5c-ai/babysitter-cursor install --global
npx --yes @a5c-ai/babysitter-cursor install --workspace <path>

Cursor's marketplace add is UI-only (via the bundled marketplace manifest); there is no CLI marketplace add for Cursor.

Gemini

Neutral helper only — there is no standalone npm installer for this harness.

babysitter harness:install-plugin gemini-cli [--workspace <path>]

GitHub Copilot

babysitter harness:install-plugin github-copilot [--workspace <path>]
copilot plugin marketplace add a5c-ai/babysitter-github-copilot && copilot plugin install babysitter
copilot plugin install a5c-ai/babysitter-github-copilot
babysitter-github install --cloud-agent --workspace <path>

Hermes

babysitter harness:install-plugin hermes [--workspace <path>]

oh-my-pi

babysitter harness:install-plugin oh-my-pi [--workspace <path>]
npx --yes @a5c-ai/babysitter-omp install --global
npx --yes @a5c-ai/babysitter-omp install --workspace <path>
omp plugin install @a5c-ai/babysitter-omp

openclaw

babysitter harness:install-plugin openclaw [--workspace <path>]
npx --yes @a5c-ai/babysitter-openclaw install --global
npx --yes @a5c-ai/babysitter-openclaw install --workspace <path>

opencode

babysitter harness:install-plugin opencode [--workspace <path>]
npx --yes @a5c-ai/babysitter-opencode install --global
npx --yes @a5c-ai/babysitter-opencode install --workspace <path>
npx --yes @a5c-ai/babysitter-opencode install --accomplish

Pi

babysitter harness:install-plugin pi [--workspace <path>]
npx --yes @a5c-ai/babysitter-pi install --global
npx --yes @a5c-ai/babysitter-pi install --workspace <path>
pi install npm:@a5c-ai/babysitter-pi
pi install -l npm:@a5c-ai/babysitter-pi

On Pi, /resume is reserved by the harness, so use /babysitter:resume.

genty

Install via the SDK helper or the npm-only installer:

babysitter harness:install-plugin genty [--workspace <path>] npx --yes @a5c-ai/babysitter-genty install --global npx --yes @a5c-ai/babysitter-genty install --workspace <path>

For the full per-harness reference (invocation tokens and hook/continuation models), see the Install Matrix.

---

Step 4 — Verify

Run the v6 verification checks from the Migration Guide checklist.

Check the host-side Adapters CLI health:

adapters doctor

Run a smoke test against an installed harness:

adapters run claude "say hi"

Confirm the core CLI is on the v6 line (expect a 5.x version, 5.1.0 for this edition):

babysitter --version

Finally, re-run a known process to confirm your workflows still behave as expected.

---

Rollback

If you need to return to the prod 0.0.x series, reinstall the prod global CLI/SDK at the last prod release:

npm install -g @a5c-ai/babysitter-sdk@0.0.175

Then reinstall your old harness plugin (for Claude Code, re-add the marketplace and install the plugin as you did under prod).

**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.

---

Related Documentation

• Migration Guide — the full breaking-changes list
• Installation — the standard v6 install guide
• Install Matrix — every harness key, install command, and hook model
• Adapters — why Babysitter is harness-agnostic
• Hooks — per-harness continuation models

---

Next steps

• **Next:** Quickstart — run your first v6 workflow
• **Related:** Migration Guide · Installation
• **Related:** Install Matrix · Adapters CLI