{
  "id": "page:docs-plugins",
  "_kind": "Page",
  "_file": "wiki/docs/plugins.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/plugins.md",
    "sourceKind": "repo-docs",
    "title": "Agent Plugins",
    "displayName": "Agent Plugins",
    "slug": "docs/plugins",
    "articlePath": "wiki/docs/plugins.md",
    "article": "\n# Agent Plugins\n\nAgent plugins are the harness integration packages that install Babysitter into tools such as Claude Code, Codex, Cursor, Gemini CLI, OpenCode, and GitHub Actions. They remain plugins.\n\nBabysitter marketplace installables were renamed to [blueprints](blueprints.md). Use this page for harness plugin packages and agent-runtime integration details. Use the blueprints page for marketplace packages, `install.md` instructions, registry operations, and `blueprint:*` CLI commands.\n\n<!-- supported-harness-plugins:start -->\n## Supported harness plugin packages\n\n`plugins/babysitter-unified/` is the only maintained source tree in this repo.\nHarness-specific bundles are generated from it and published as npm packages or\nexternal plugin repos; they are not maintained as checked-in directories here.\n\nUse this table when you need the canonical entrypoint for a specific Babysitter harness/plugin package rather than the broader blueprint marketplace explanation.\n\n| Surface | Canonical docs home | Status note |\n| --- | --- | --- |\n| `plugins/babysitter-unified` | [plugins/babysitter-unified/per-harness/claude-code/README.md](../plugins/babysitter-unified/per-harness/claude-code/README.md) | Canonical authoring source plus Claude Code surface. |\n| `@a5c-ai/babysitter-codex` | [plugins/babysitter-unified/per-harness/codex/README.md](../plugins/babysitter-unified/per-harness/codex/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n| `@a5c-ai/babysitter-cursor` | [plugins/babysitter-unified/per-harness/cursor/README.md](../plugins/babysitter-unified/per-harness/cursor/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n| `babysitter-gemini` | [plugins/babysitter-unified/per-harness/gemini/README.md](../plugins/babysitter-unified/per-harness/gemini/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n| `babysitter-github` | [plugins/babysitter-unified/per-harness/github/README.md](../plugins/babysitter-unified/per-harness/github/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n| `@a5c-ai/babysitter-omp` | [plugins/babysitter-unified/per-harness/omp/README.md](../plugins/babysitter-unified/per-harness/omp/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n| `@a5c-ai/babysitter-openclaw` | [plugins/babysitter-unified/per-harness/openclaw/README.md](../plugins/babysitter-unified/per-harness/openclaw/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n| `@a5c-ai/babysitter-opencode` | [plugins/babysitter-unified/per-harness/opencode/README.md](../plugins/babysitter-unified/per-harness/opencode/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n| `@a5c-ai/babysitter-pi` | [plugins/babysitter-unified/per-harness/pi/README.md](../plugins/babysitter-unified/per-harness/pi/README.md) | Generated from the unified source; README is the canonical package-level contract. |\n<!-- supported-harness-plugins:end -->\n\n## Bridge Flags for adapters Launch\n\nWhen launching agents through `adapters launch`, two bridge flags control how Babysitter hooks and interactive orchestration integrate with the harness:\n\n- `--bridge-interactive` enables an interactive bridge layer that proxies stdin/stdout through an intermediary capable of injecting Babysitter hook responses and orchestration signals while preserving the harness's native TUI.\n- `--bridge-hooks` enables hook bridging. The bridge intercepts hook lifecycle events and forwards them to the Babysitter session-start hook.\n\nThe `hookSupport` and `bridgeCapabilities` attributes in the atlas graph agent version nodes describe which harnesses support these flags natively. See the [adapters CLI reference](adapters/reference/10-cli-reference.md) for the full flag table.\n\n## Plugin Mode And External Responders\n\nWhen Babysitter runs inside a host agent plugin, most effects are host-resolvable: the host agent can edit files, run approved tools, answer breakpoints, and post task results back to the run.\n\nExternal agent responder effects are different. A process can mark an agent task with `responderType: \"agent\"` and an adapters `adapter`; tasks-adapter then resolves that effect through adapters instead of handing it back to the host as ordinary tool work.\n\nThis keeps the plugin contract small:\n\n- Host-resolvable effects stay with the current host agent.\n- External agent responder effects route through tasks-adapter, adapters, and the `adapterBridge` integration.\n- Fallback to the internal agent path must be explicit, using the current fallback field documented in the agent-reference docs.\n\nFor task shape, fallback behavior, and troubleshooting, see [Process Authoring Policy](agent-reference/process-authoring.md#agent-task-responders) and [Command Surfaces](agent-reference/command-surfaces.md#external-agent-dispatch).\n\n## Names That Stay As Plugins\n\nThe blueprints rename does not change agent harness plugin concepts. These names remain plugin-specific:\n\n- `CLAUDE_PLUGIN_ROOT`\n- `PI_PLUGIN_ROOT`\n- `.claude/plugins/`\n- `packages/adapters/hooks/`\n- `packages/extensions-adapter/`\n- Agent plugin `plugin.json` manifests\n- Agent plugin `install.md` files\n\n## Built-in Quality Gates\n\nThe `babysitter-unified` plugin ships a small set of pre-deploy gates as flat command markdown files under `plugins/babysitter-unified/commands/`. Each command pairs a user-facing slash invocation with reusable process helpers, so the gate can be invoked manually or composed programmatically.\n\n### `babysitter:check-forbidden-markers`\n\nPre-deploy substring grep for obsolete code paths that must never re-ship after a refactor or restart-from-baseline. Reads a project-local `scripts/forbidden-markers.txt` and scans built assets for forbidden markers.\n\n- Helper: `library/processes/shared/forbidden-markers-scanner.js`\n- Slash command: `plugins/babysitter-unified/commands/check-forbidden-markers.md`\n\n## Further Reading\n\n- [Babysitter Blueprints](blueprints.md)\n- [Command Surfaces](agent-reference/command-surfaces.md)\n- [Process Authoring Policy](agent-reference/process-authoring.md)\n",
    "documents": []
  },
  "outgoingEdges": [
    {
      "from": "page:docs-plugins",
      "to": "page:docs-plugins-cli-reference",
      "kind": "contains_page"
    },
    {
      "from": "page:docs-plugins",
      "to": "page:docs-plugins-marketplace-format",
      "kind": "contains_page"
    },
    {
      "from": "page:docs-plugins",
      "to": "page:docs-plugins-migration-guide",
      "kind": "contains_page"
    },
    {
      "from": "page:docs-plugins",
      "to": "page:docs-plugins-plugin-author-guide",
      "kind": "contains_page"
    }
  ],
  "incomingEdges": [
    {
      "from": "page:docs",
      "to": "page:docs-plugins",
      "kind": "contains_page"
    }
  ]
}