| name | babysitter:call |
| description | Start a babysitter orchestration run. Use this command to start babysitting a complex workflow. |
| argument-hint | Specific instructions for the run |
babysitter:call
Orchestrate .a5c/runs/<runId>/ through iterative execution. Use the babysitter SDK CLI to drive the orchestration loop inside Codex CLI.
Dependencies
Ensure babysitter CLI is available:
npx -y @a5c-ai/babysitter-sdk@0.0.173 version --json
Workflow
1. Interview Phase (Interactive)
Gather user intent, requirements, goals, and scope. Research the repo structure, search the process library for relevant specializations and methodologies.
2. Process Creation
Create the process .js file with task definitions. Install @a5c-ai/babysitter-sdk in .a5c/package.json if not present.
Process/Skill Library Roots (Codex Mapping)
When searching for reusable processes, skills, and agents:
- Project-local processes:
.a5c/processes
- Bundled upstream library:
upstream/babysitter/skills/babysit/process
- Bundled upstream references:
upstream/babysitter/skills/babysit/reference
Override process root with BABYSITTER_PROCESS_LIBRARY_ROOT when needed.
3. Create Run
babysitter run:create \
--process-id <id> \
--entry <path>#<export> \
--inputs <inputs-file> \
--prompt "$PROMPT" \
--harness codex \
--session-id "${CODEX_THREAD_ID:-$CODEX_SESSION_ID}" \
--plugin-root "$CODEX_PLUGIN_ROOT" \
--json
4. Iteration Loop
babysitter run:iterate .a5c/runs/<runId> --json --iteration <n> --plugin-root "$CODEX_PLUGIN_ROOT"
For each pending task:
- agent — Build prompt from role/task/instructions, execute via Codex tools
- node — Execute Node.js script via shell
- shell — Run shell command directly
- breakpoint — Pause for user approval (interactive) or auto-resolve (yolo)
- sleep — Wait until timestamp
- skill — Load and follow SKILL.md instructions
- hook — Fire named lifecycle hook
- parallel — Execute sub-effects concurrently
- orchestrator_task — Delegate sub-orchestration
5. Post Results
Write result value to a separate file, then post via CLI:
babysitter task:post .a5c/runs/<runId> <effectId> \
--status ok \
--value tasks/<effectId>/output.json \
--json
6. Check Completion
When run:iterate returns status: "completed" with a completionProof, the run is done. Return the proof wrapped in <promise>PROOF</promise> to signal completion.
Profile Integration
Read user profile for personalization:
babysitter profile:read --user --json
babysitter profile:read --project --json
Quick Reference
| Command | Description |
|---|
run:create | Create and bind a new run |
run:iterate | Get next pending tasks |
run:status | Check run state |
task:list --pending | List pending effects |
task:post | Post task result |
session:resume | Resume existing session |
skill:discover | Find available skills/agents |
health --json | SDK health check |
