{
  "id": "page:docs-user-guide-ecosystem-overview",
  "_kind": "Page",
  "_file": "wiki/docs/user-guide/ecosystem/overview.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/user-guide/ecosystem/overview.md",
    "sourceKind": "repo-docs",
    "title": "Babysitter Ecosystem Overview",
    "displayName": "Babysitter Ecosystem Overview",
    "slug": "docs/user-guide/ecosystem/overview",
    "articlePath": "wiki/docs/user-guide/ecosystem/overview.md",
    "article": "\n[Docs](../index.md) › [Ecosystem](#) › Overview\n\n# Babysitter Ecosystem Overview\n\n**The Babysitter repository is a monorepo: one core orchestration engine plus a family of packages that surround it — a catalog, an agent runtime, adapters, a dashboard, and adjacent products. This page explains what each component is and helps you pick the ones you actually need.**\n\nIf you only want to run AI coding work under a deterministic, enforced process, you need very little of this — the core SDK and a harness plugin. Everything else exists to extend that core to more surfaces (CI, Kubernetes, browser), more harnesses, richer observability, and a shared knowledge graph.\n\n> **Positioning reminder:** Babysitter's value proposition is **deterministic process execution + complex agentic workflows + policy/process adherence (obedience)** — \"Enforcement, not Assistance.\" Every component below serves that thesis. Quality convergence is one capability of the engine, not the product.\n\n---\n\n## On this page\n\n- [What the monorepo is](#what-the-monorepo-is)\n- [The component map](#the-component-map)\n- [How to choose](#how-to-choose)\n- [Maturity at a glance](#maturity-at-a-glance)\n- [Naming notes](#naming-notes)\n- [Next steps](#next-steps)\n\n---\n\n## What the monorepo is\n\nThe repository (`a5c-ai/babysitter`) holds the entire stack under `packages/`. At its center is the **event-sourced orchestration engine** (`@a5c-ai/babysitter-sdk`): your workflow is real JavaScript code, the orchestrator can only do what that code permits, every step is recorded in an immutable journal, and a hook-enforced **mandatory stop** after each step decides what the process permits next. That is the obedience mechanism.\n\nEverything else in the monorepo is built around that engine:\n\n- A **knowledge graph / catalog** (atlas) that supplies harness, plugin, and topology metadata as generated data, so adding a harness is a data change rather than a code change.\n- An **agent runtime product** (genty) that packages the agent loop, daemon, and platform layers into a single `genty` binary and exposes the headless/internal harness.\n- An **adapters family** (20 package directories) that multiplexes a single integration definition out to many harnesses, transports, CI triggers, plugin formats, and lifecycle hooks.\n- A **real-time dashboard** (observer-dashboard) that streams the journal over SSE.\n- Two **adjacent / forward-looking** components: kradle (a Kubernetes-native Git forge, MVP) and kip-sdk (a memory substrate that is **spec/design only — no shipping code**).\n\n---\n\n## The component map\n\n| Component | Package(s) | What it is | Maturity | Read |\n|-----------|-----------|------------|----------|------|\n| **babysitter-sdk** | `@a5c-ai/babysitter-sdk` | The core event-sourced orchestration engine: `defineTask`, the effect/journal engine, the built-in Pi execution engine, token compression. Everything else depends on it. | GA | [SDK overview](./babysitter-sdk.md) |\n| **babysitter (metapackage)** | `@a5c-ai/babysitter` | Convenience install that pulls in the babysitter npm packages and ships the `babysitter` bin shim. The recommended human-facing install. | GA | [SDK overview](./babysitter-sdk.md) |\n| **adapters** | `@a5c-ai/adapters` (+ 19 sibling packages) | A **family** of packages that multiplex one integration definition to many targets: triggers (CI), extensions (plugin compile), hooks (mandatory-stop lifecycle), proxy (140+ providers), tasks (durable breakpoints), and more. | GA | [Adapters overview](./adapters.md) · [Adapter types](../reference/adapter-types.md) |\n| **atlas** | `@a5c-ai/atlas` | The unified knowledge graph / catalog: YAML graph → generated TS types → JSON snapshots consumed at runtime. Single source of truth for harness metadata, discovery, plugin targets, and topology. Ships the `atlas` CLI. | GA | [Atlas overview](./atlas.md) |\n| **genty** | `@a5c-ai/genty` + `-core` / `-runtime` / `-platform` | The unified agent product (renamed from \"tula\") that composes the agent stack into the single `genty` binary: agent loop, daemon/session/cost, harness integration and governance. Surfaces the internal/headless harness. | GA | [Genty overview](./genty.md) |\n| **observer-dashboard** | `@a5c-ai/babysitter-observer-dashboard` | A Next.js real-time observability dashboard that streams run/journal events over SSE and virtualizes large run histories. | GA | [Observer Dashboard overview](./observer-dashboard.md) |\n| **kradle** | `@a5c-ai/kradle` + `@a5c-ai/kradle-cli` | A Kubernetes-native Git forge runtime (Argo CD GitOps + Gitea hosting) with a per-org dispatchable assistant. | MVP | [Kradle overview](./kradle.md) |\n| **kip-sdk** | no published package (spec-only); path `packages/kip-sdk` | A **spec/design-only** memory substrate (K/I/P): git-substrate, bitemporal, signed-fact property graph. **No code — Markdown spec only.** | Spec only | [kip-sdk overview](./kip-sdk.md) |\n\n> The canonical machine-readable map of public/internal packages, apps, and harness plugins lives at [Package & Plugin Map](../../package-and-plugin-map.md).\n\n---\n\n## How to choose\n\nPick by what you are trying to do:\n\n- **\"I just want to run AI coding work under an enforced process.\"**\n  Install the metapackage `@a5c-ai/babysitter` and your harness plugin. You get the engine + the `babysitter` CLI. See [Installation](../getting-started/installation.md) and [Quickstart](../getting-started/quickstart.md). You do not need atlas, genty, kradle, or kip directly — the engine pulls in what it needs.\n\n- **\"I want to run a process headlessly, in CI, or via the internal harness.\"**\n  Use [genty](./genty.md) (`@a5c-ai/genty-platform`) for `genty call --harness internal`, daemon, MCP serving, and the TUI; and the **triggers adapter** ([adapter types](../reference/adapter-types.md)) as the GitHub Action / CI entrypoint.\n\n- **\"I want to run on a harness other than Claude Code.\"**\n  This is the [adapters](./adapters.md) family's job — codecs drive each harness, extensions compile one plugin manifest into per-harness formats, and hooks enforce the mandatory stop across all of them. See the [Install Matrix](../harnesses/install-matrix.md).\n\n- **\"I want to free a vendor-locked harness from a single backend.\"**\n  Use the **proxy adapter** (Python LiteLLM bridge, 140+ providers) via `adapters launch --with-proxy-if-needed`. See [adapter types](../reference/adapter-types.md).\n\n- **\"I want durable human-approval breakpoints that survive cold starts / serverless.\"**\n  Use the **tasks adapter** (the Breakpoints Adapter) — durable backends including GitHub Issues. See [Breakpoints](../features/breakpoints.md).\n\n- **\"I want to watch runs in real time.\"**\n  Use the [observer dashboard](./observer-dashboard.md) (`/babysitter:observe` or `genty observe`).\n\n- **\"I want harness/plugin/discovery metadata or a queryable catalog.\"**\n  That is [atlas](./atlas.md) and its `atlas` CLI.\n\n- **\"I want a self-hosted, Kubernetes-native Git forge with built-in agent dispatch.\"**\n  Look at [kradle](./kradle.md) — but note it is an **MVP**.\n\n- **\"I'm researching the memory/context-management design.\"**\n  Read [kip-sdk](./kip-sdk.md), and understand it is **spec only — there is no implementation to install.**\n\n---\n\n## Maturity at a glance\n\nBe honest about what is shipping versus what is forward-looking:\n\n| Component | Status | What \"status\" means here |\n|-----------|--------|--------------------------|\n| babysitter-sdk / babysitter / atlas / genty / observer-dashboard | **GA** (v6.0.0) | Versioned, runtime, generally available. |\n| adapters family | **GA** | Versioned and consumed by the runtime. A couple of subdirs are thin (see [adapter types](../reference/adapter-types.md) for the honest per-package notes). |\n| kradle | **MVP** | Described by its own README as an \"executable MVP runtime and handoff package.\" Early; expect rough edges. |\n| kip-sdk | **Spec only** | Entirely Markdown — `SPEC.md` + numbered design docs. No `package.json`, no `src/`. Treat any kip \"feature\" as **design, not shipping code.** |\n\n---\n\n## Naming notes\n\n- The agent runtime product is **genty** (binary `genty`), backed by `@a5c-ai/genty-platform`. Some older material (the `docs/v6-announcement.md` dated April 2026) refers to `agent-platform` / `babysitter-harness`; that naming is stale. The README and package metadata are authoritative — standardize on **genty / `@a5c-ai/genty-platform`**.\n- \"genty harness\" in everyday usage means running processes through the **genty CLI on the SDK's internal Pi engine** (`genty call --harness internal`). There is no standalone `genty` codec in the codecs package.\n- The **adapters** family keeps its name precisely because it is not genty-specific — it multiplexes for *all* agents.\n\n---\n\n## Next steps\n\n- **Start with the engine:** [babysitter-sdk overview](./babysitter-sdk.md)\n- **See how it all fits together:** [Architecture & How It Fits Together](../architecture.md)\n- **Understand the adapter family:** [Adapter Types reference](../reference/adapter-types.md)\n- **Install and run:** [Installation](../getting-started/installation.md) → [Quickstart](../getting-started/quickstart.md)\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-user-guide",
      "to": "page:docs-user-guide-ecosystem-overview",
      "kind": "contains_page"
    }
  ]
}