{
  "id": "page:docs-agent-reference-command-surfaces",
  "_kind": "Page",
  "_file": "wiki/docs/agent-reference/command-surfaces.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/agent-reference/command-surfaces.md",
    "sourceKind": "repo-docs",
    "title": "Command Surfaces",
    "displayName": "Command Surfaces",
    "slug": "docs/agent-reference/command-surfaces",
    "articlePath": "wiki/docs/agent-reference/command-surfaces.md",
    "article": "\n# Command Surfaces\n\nThis page is the concise command map for contributors and coding agents. It is intentionally grouped by surface so `AGENTS.md` and `CLAUDE.md` do not need to inline large command dumps.\n\n## Core CLI: `babysitter`\n\nThe `babysitter` binary is shipped by [`@a5c-ai/babysitter`](../../packages/babysitter/package.json) and [`@a5c-ai/babysitter-sdk`](../../packages/sdk/package.json). The command families currently registered in the repo source live in [`packages/sdk/src/cli/main/program.ts`](../../packages/sdk/src/cli/main/program.ts).\n\n### Agent-facing help\n\n`babysitter --help` is the automation surface. Its usage text is generated from [`packages/sdk/src/cli/main/usage.ts`](../../packages/sdk/src/cli/main/usage.ts) and centers on:\n\n- `run:*` and `task:*` for deterministic replay loops (includes `run:assign-process` for attaching a process to a bare run)\n- `session:*` for session binding and iteration guards\n- `skill:discover`\n- `process-library:active`\n- `profile:*`\n- `instructions:babysit-skill`\n- `harness:install` and `harness:install-plugin`\n\n### Human-facing help\n\n`babysitter --help-human` is the operator surface. It adds:\n\n- `log`, `hook:*`, `compress-output`\n- `skill:fetch-remote`\n- `process-library:clone|update|use`\n- `plugin:*`\n- `tokens:stats`\n- `compression:*`\n- `harness:discover|list`\n- `instructions:process-create|orchestrate|breakpoint-handling`\n- `breakpoint:*`\n- `health`, `configure`, `version`\n\n## Harness Runtime CLI: `babysitter-agent`\n\nThe optional runtime binary comes from [`@a5c-ai/babysitter-agent`](../../packages/babysitter-agent/package.json) and is registered as `babysitter-agent` with `babysitter-harness` kept only as a compatibility binary.\n\nUse \babysitter-agent call for new runtime orchestration examples. The legacy \babysitter harness:call alias is deprecated and should not be introduced in new tests or docs.\n\nSetup remains on the core CLI through \babysitter harness:install and \babysitter harness:install-plugin.\n\nUse it for human-invoked orchestration sessions and runtime services:\n\n- `create-run`, `call`, `yolo`, `plan`, `forever`\n- `resume-run`, `resume`\n- `retrospect`, `cleanup`, `assimilate`, `doctor`, `contrib`\n- `anycli`, `session-history`\n- `observe`, `tui`\n- `daemon:*`, `cost:stats`, `start-server`\n- `discover`, `list`, `invoke`\n\n## Runs Directory Defaults\n\nThe repo source now treats global runs storage as the default:\n\n- default scope: `~/.a5c/runs`\n- repo scope: `<repo>/.a5c/runs` when `BABYSITTER_RUNS_SCOPE=repo`\n- explicit override: `BABYSITTER_RUNS_DIR` or `--runs-dir`\n\nThe implementation lives in [`packages/sdk/src/config/runs.ts`](../../packages/sdk/src/config/runs.ts) and the default config in [`packages/sdk/src/config/defaults.ts`](../../packages/sdk/src/config/defaults.ts).\n\nWhen reading existing runs, the SDK also probes repo-local `.a5c/runs` for backward compatibility.\n\n## Plugin Commands\n\nPlugin concepts are covered in [Plugins Overview](../plugins.md). The dedicated command reference is [Plugin CLI Reference](../plugins/cli-reference.md).\n\nOne current implementation detail worth remembering: `plugin:install`, `plugin:update`, and `plugin:configure` can auto-resolve the marketplace when `--marketplace-name` is omitted, as implemented in [`packages/sdk/src/cli/commands/plugin/packageCommands.ts`](../../packages/sdk/src/cli/commands/plugin/packageCommands.ts).\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": []
}