A5C Babysitter

<div align="center"> # Babysitter https://a5c.ai --- [](https://www.npmjs.com/package/@a5c-ai/babysitter-sdk) [](https://opensource.org/licenses/MIT) [](https://github.com/a5c-ai/babysitter/issues) [](https://github.com/a5c-ai/babysitter/stargazers) > **Enforce obedience to agentic workforces. Manage extremely complex workflows through deterministic, hallucination-free self-orchestration.** [Getting Started](#installation) | [Documentation](#documentation) | [Community](#community-and-support) </div> --- https://github.com/user-attachments/assets/8c3b0078-9396-48e8-aa43-5f40da30c20b --- ## Table of Contents - [What is Babysitter?](#what-is-babysitter) - [Prerequisites](#prerequisites) - [Installation](#installation) - [First Steps](#first-steps) - [Quick Start](#quick-start) - [How It Works](#how-it-works) - [Why Babysitter?](#why-babysitter) - [Documentation](#documentation) - [Contributing](#contributing) - [Community and Support](#community-and-support) - [License](#license) --- ## What is Babysitter? Babysitter enforces obedience to agentic workforces, enabling them to manage extremely complex tasks and workflows through deterministic, hallucination-free self-orchestration. Define your workflow in code - Babysitter enforces every step, ensures quality gates pass before progression, requires human approval at breakpoints, and records every decision in an immutable journal. Your agents do exactly what the process permits, nothing more. --- ## Prerequisites - **Node.js**: Version 20.0.0+ (22.x LTS recommended) - **Claude Code**: Latest version ([docs](https://code.claude.com/docs/en/quickstart)) - **Git**: For cloning (optional) --- ## Installation ### 1. Install the Plugin ```bash claude plugin marketplace add a5c-ai/babysitter claude plugin install --scope user [email protected] ``` Then restart Claude Code. ### 2. Verify Installation Type `/skills` in Claude Code to verify "babysit" appears. ### Codex CLI Integration (babysitter-codex) Codex support is available as a dedicated plugin bundle in: `plugins/babysitter-codex` It includes Codex hook wiring, slash command dispatch, and orchestration harness scripts compatible with the Babysitter SDK. --- ## First Steps After installation, set up your environment: ### 1. Configure Your Profile (One-Time) ```bash /babysitter:user-install ``` This creates your personal profile with: - Breakpoint preferences (how much oversight you want) - Tool preferences and communication style - Expertise areas for better process matching ### 2. Set Up Your Project ```bash /babysitter:project-install ``` This analyzes your codebase and configures: - Project-specific workflows - Test frameworks and CI/CD integration - Tech stack preferences ### 3. Verify Setup ```bash /babysitter:doctor ``` Run diagnostics to confirm everything is working. --- ## Quick Start ```bash claude "/babysitter:call implement user authentication with TDD" ``` Or in natural language: ``` Use the babysitter skill to implement user authentication with TDD ``` Claude will create an orchestration run, execute tasks step-by-step, handle quality checks and approvals, and continue until completion. ### Choose Your Mode | Mode | Command | When to Use | |------|---------|-------------| | **Interactive** | `/babysitter:call` | Learning, critical workflows - pauses for approval | | **Autonomous** | `/babysitter:yolo` | Trusted tasks - full auto, no breakpoints | | **Planning** | `/babysitter:plan` | Review process before executing | | **Continuous** | `/babysitter:forever` | Monitoring, periodic tasks - runs indefinitely | ### Utility Commands | Command | Purpose | |---------|----------| | `/babysitter:doctor` | Diagnose run health and issues | | `/babysitter:observe` | Launch real-time monitoring dashboard | | `/babysitter:resume` | Continue an interrupted run | | `/babysitter:help` | Documentation and usage help | --- ## How It Works ``` +=============================================================================+ | /babysitter:call | +=============================================================================+ | | | YOUR PROCESS (JavaScript) This is the AUTHORITY | | +----------------------------------------+ | | | async function process(inputs, ctx) { | Real code, not config. | | | | The orchestrator can ONLY | | | await ctx.task(plan, { ... }); | do what this code permits. | | | | | | | await ctx.breakpoint({ | Breakpoints = human gates | | | question: 'Approve plan?' | (enforced, not optional) | | | }); | | | | | | | | await ctx.task(implement, { ... }); | Tasks = executable work | | | | | | | const score = await ctx.task(verify);| Quality gates = code logic | | | if (score < 80) | (not config, real checks) | | | await ctx.task(refine, { ... }); | | | | } | | | +-------------------+--------------------+ | | | | | | governs | | v | | +---------------------------------------------------------------------+ | | | ENFORCEMENT MECHANISM | | | | | | | | +-------------+ +------------------+ +-----------------+ | | | | | MANDATORY |---->| PROCESS CHECK |---->| DECISION | | | | | | STOP | | What does the | | | | | | | | (enforced | | process permit | | Permitted: next | | | | | | by hook) | | next? | | task assigned | | | | | +-------------+ +------------------+ | | | | | | | | Blocked: halt | | | | | v | until gate | | | | | +--------------+ | passes | | | | | | Gate/task | +-----------------+ | | | | | from code | | | | | +--------------+ | | | +---------------------------------------------------------------------+ | | | | | | records every decision | | v | | +---------------------------------------------------------------------+ | | | JOURNAL: Every task, gate, decision - immutable, replayable | | | +---------------------------------------------------------------------+ | | | +===