{
  "id": "page:docs-user-guide-getting-started-migration",
  "_kind": "Page",
  "_file": "wiki/docs/user-guide/getting-started/migration.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/user-guide/getting-started/migration.md",
    "sourceKind": "repo-docs",
    "title": "Migration Guide: Prod (0.0.x) to v6 (6.0.0)",
    "displayName": "Migration Guide: Prod (0.0.x) to v6 (6.0.0)",
    "slug": "docs/user-guide/getting-started/migration",
    "articlePath": "wiki/docs/user-guide/getting-started/migration.md",
    "article": "\n[Docs](../index.md) › [Getting Started](./README.md) › Migration\n\n# Migration Guide: Prod (0.0.x) to v6 (6.0.0)\n\n**Category:** Getting Started · **Last Updated:** 2026-06-22\n\n## On this page\n\n- [In Plain English](#in-plain-english)\n- [Version Jump](#version-jump)\n- [Breaking Changes](#breaking-changes)\n- [Deprecated (still works, will be removed)](#deprecated-still-works-will-be-removed)\n- [Migration Checklist](#migration-checklist)\n- [Related Documentation](#related-documentation)\n\n---\n\n## In Plain English\n\n**v6 is a major upgrade. The biggest change is that Babysitter is now harness-agnostic (via [Adapters](../features/adapters.md)) instead of Claude-only.** Along with that come a few breaking changes: the install package changed, two environment variables were renamed, one flag was removed, and the `plugins/` directory was renamed to `blueprints/`.\n\nThis page lists every breaking change and what to do about it. Read it before upgrading from the `0.0.x` series (last prod release: `0.0.175`).\n\n---\n\n## Version Jump\n\n| Surface | Prod | v6 |\n|---------|------|-----|\n| Core CLI / SDK | `0.0.175` | **6.0.0** |\n| Adapters CLI | (did not exist) | **6.0.0** |\n| Edition | - | **v6** |\n\nThis is a deliberate **semver-major jump**. Treat the upgrade as a breaking change and test your processes after migrating.\n\n---\n\n## Breaking Changes\n\n### 1. Install package changed\n\nThe primary install is now **`@a5c-ai/babysitter`** (core CLI), not `@a5c-ai/babysitter-sdk`.\n\n```bash\n# Before (prod)\nnpm install -g @a5c-ai/babysitter-sdk@latest\n\n# v6\nnpm install -g @a5c-ai/babysitter\nnpm install -g @a5c-ai/adapters-cli   # new host-side CLI\n```\n\nThe toolchain is now split across `@a5c-ai/babysitter` (core CLI), `@a5c-ai/babysitter-sdk` (programmatic runtime), and `@a5c-ai/genty-platform`. See [Installation](./installation.md).\n\n### 2. Environment variable renames\n\n| Before (deprecated) | v6 |\n|---------------------|-----|\n| `BABYSITTER_SESSION_ID` | **`AGENT_SESSION_ID`** |\n| `CLAUDE_SESSION_ID` | harness-agnostic session ID (`AGENT_SESSION_ID`) |\n| `CLAUDE_PLUGIN_ROOT` | harness-agnostic plugin root |\n\nSession resolution is now **PID-scoped** rather than env-first. If you relied on inheriting a session ID from the environment, set `BABYSITTER_TRUST_ENV_SESSION=1` as an explicit escape hatch. See [Configuration](../reference/configuration.md) and [Run Resumption](../features/run-resumption.md).\n\n### 3. Removed flag: `--plugin-root`\n\n`--plugin-root` is **removed**. Plugin/root resolution is handled by the harness-agnostic runtime. Remove it from any scripts.\n\n### 4. `plugins/` → `blueprints/`\n\nThe processes directory was renamed:\n\n| Before | v6 |\n|--------|-----|\n| `plugins/` | **`blueprints/`** |\n| `plugin:*` commands | **`blueprints:*`** (the `plugin:*` aliases are retained for one release and marked deprecated) |\n\nUpdate any paths and scripts that referenced `plugins/`. See [Process Library](../features/process-library.md).\n\n### 5. Concept and package renames\n\n| Before (deprecated) | v6 |\n|---------------------|-----|\n| Agent Mux / `-mux` packages | **Adapters** / `-adapter` packages |\n| `tula` | **genty** |\n| `Krate` | **Kradle** |\n| `breakpoints-pro` | **Breakpoints Adapter** (serverless-durable; pluggable backends) |\n\n### 6. Harness model\n\nBabysitter is no longer wired specifically to Claude Code's `Stop` hook. The orchestration runtime is harness-agnostic, and each harness has its own continuation model. If you wrote integration code against the Claude `Stop` loop, see [Adapters](../features/adapters.md) and [Hooks](../features/hooks.md).\n\n---\n\n## Deprecated (still works, will be removed)\n\n- `plugin:*` command aliases (use `blueprints:*`)\n- `BABYSITTER_SESSION_ID` (use `AGENT_SESSION_ID`)\n- `breakpoints-pro` references (use the Breakpoints Adapter)\n\nThese are marked deprecated throughout the docs and will be removed in a future release.\n\n---\n\n## Migration Checklist\n\n1. [ ] Upgrade Node.js to >=20.9.0 (for the Adapters CLI).\n2. [ ] Install `@a5c-ai/babysitter` and `@a5c-ai/adapters-cli`.\n3. [ ] Replace `BABYSITTER_SESSION_ID` with `AGENT_SESSION_ID` in env/scripts.\n4. [ ] Remove `--plugin-root` from any commands.\n5. [ ] Rename `plugins/` references to `blueprints/`.\n6. [ ] Reinstall your harness plugin from the [Install Matrix](../harnesses/install-matrix.md).\n7. [ ] Run `adapters doctor` and a smoke test (`adapters run claude \"say hi\"`).\n8. [ ] Re-run a known process to confirm behavior.\n\n---\n\n## Related Documentation\n\n- [Installation](./installation.md) · [Quickstart](./quickstart.md)\n- [Adapters](../features/adapters.md) · [Hooks](../features/hooks.md)\n- [Configuration](../reference/configuration.md) · [Glossary](../reference/glossary.md)\n- [Install Matrix](../harnesses/install-matrix.md)\n\n---\n\n## Next steps\n\n- **Next:** [Installation](./installation.md) — install the v6 packages\n- **Related:** [CLI Reference](../reference/cli-reference.md)\n- **Related:** [Adapters CLI](../reference/adapters-cli.md)\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-user-guide-getting-started",
      "to": "page:docs-user-guide-getting-started-migration",
      "kind": "contains_page"
    }
  ]
}