{
  "id": "page:docs-user-guide-harnesses-codex",
  "_kind": "Page",
  "_file": "wiki/docs/user-guide/harnesses/codex.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/user-guide/harnesses/codex.md",
    "sourceKind": "repo-docs",
    "title": "Codex",
    "displayName": "Codex",
    "slug": "docs/user-guide/harnesses/codex",
    "articlePath": "wiki/docs/user-guide/harnesses/codex.md",
    "article": "\n[Docs](../index.md) › [Harnesses](./install-matrix.md) › Codex\n\n# Codex\n\n**Tier:** Fully supported · **Repo:** `a5c-ai/babysitter-codex` · **Harness key:** `codex`\n\n---\n\n## In Plain English\n\n**On Codex you get the full Babysitter experience through the `$` mention picker: type `$babysitter:call` (and friends) to drive an orchestration run.**\n\nInstall the [plugin](../reference/glossary.md) once, and Babysitter surfaces as a set of skills you invoke from Codex's mention picker. The orchestration loop is driven by Codex's `SessionStart + UserPromptSubmit + Stop` hooks, auto-detected from the plugin's `hooks.json`.\n\n**Estimated time to first run:** about 5 minutes. **End state:** you can mention `$babysitter:call` in Codex and watch a run iterate to a quality target.\n\n---\n\n## On this page\n\n- [Install](#install)\n- [Verify](#verify)\n- [Command Surface](#command-surface)\n- [Hook / Continuation Model](#hook--continuation-model)\n- [First Run](#first-run)\n- [Related Documentation](#related-documentation)\n\n---\n\n## Install\n\n```bash\n# 1. Core CLI (host-side)\nnpm install -g @a5c-ai/babysitter\n\n# 2a. Marketplace path (per-repo — the package repo ships its own\n#     .agents/plugins/marketplace.json, so no --sparse needed)\ncodex plugin marketplace add a5c-ai/babysitter-codex\ncodex plugin list --marketplace babysitter\ncodex plugin add babysitter --marketplace babysitter\n\n# 2a-alt. From the monorepo with a sparse checkout:\ncodex plugin marketplace add a5c-ai/babysitter --ref <released-tag> --sparse .agents/plugins\n```\n\n> `--marketplace babysitter` is the marketplace **name** declared in the manifest, not the repo name.\n> For the monorepo form, use the released default branch / tag for `--ref` - **never** `--ref staging`. The Codex plugin publishes its own released tag; do not use a `6.0.x-staging.*` build-metadata version.\n\n**Alternative (npx installer):**\n\n```bash\nnpx --yes @a5c-ai/babysitter-codex install --global\n# or, scoped to a workspace:\nnpx --yes @a5c-ai/babysitter-codex install --workspace <path>\n```\n\n**Alternative (SDK helper):**\n\n```bash\nbabysitter harness:install-plugin codex [--workspace <path>]\n```\n\n---\n\n## Verify\n\nAfter install, open Codex and bring up the mention picker (`$`). You should see the `babysitter:*` skills (`$babysitter:babysit`, `$babysitter:call`, ...). If they are missing, re-run `codex plugin list --marketplace babysitter` to confirm the plugin is registered.\n\n---\n\n## Command Surface\n\nCodex surfaces Babysitter as skills through the `$` **mention picker** (16 skills):\n\n```\n$babysitter:assimilate    $babysitter:babysit      $babysitter:call\n$babysitter:doctor        $babysitter:forever      $babysitter:help\n$babysitter:issue         $babysitter:model        $babysitter:observe\n$babysitter:plan          $babysitter:project-install  $babysitter:resume\n$babysitter:retrospect    $babysitter:team-install $babysitter:user-install\n$babysitter:yolo\n```\n\nThe core entry point is the `babysit` skill; `$babysitter:call`, `$babysitter:plan`, and `$babysitter:resume` are the wrappers you will use most. See [Slash Commands and Modes](../reference/slash-commands.md).\n\n---\n\n## Hook / Continuation Model\n\n**Model: SessionStart + UserPromptSubmit + Stop.**\n\n- Plugin-level lifecycle hooks are auto-detected via `./hooks/hooks.json`.\n- The **proxied-stop** hook advances the orchestration loop after each turn.\n- **UserPromptSubmit** participates in prompt handling.\n\nThis differs from Claude Code (which has no `UserPromptSubmit` in its loop) and from the non-Stop harnesses entirely. See [Hooks](../features/hooks.md) for the full per-harness table.\n\n---\n\n## First Run\n\n```\n$babysitter:call build a calculator with add, subtract, multiply, divide using TDD\n```\n\nBabysitter creates a run and iterates toward your quality target, pausing for approval at breakpoints. Resume with `$babysitter:resume`.\n\n---\n\n## Related Documentation\n\n- [Installation](../getting-started/installation.md) · [Quickstart](../getting-started/quickstart.md)\n- [Slash Commands and Modes](../reference/slash-commands.md)\n- [Hooks](../features/hooks.md) · [Adapters](../features/adapters.md)\n- [Install Matrix](install-matrix.md) - all other supported harnesses\n- [Claude Code](claude-code.md) - the other fully-supported harness\n\n---\n\n## Next steps\n\n- **Next:** [Install Matrix](./install-matrix.md)\n- **Related:** [Claude Code](./claude-code.md), [Slash Commands](../reference/slash-commands.md), [Adapters](../features/adapters.md)\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-user-guide",
      "to": "page:docs-user-guide-harnesses-codex",
      "kind": "contains_page"
    }
  ]
}