Open Agent Toolkit (OAT)

Open Agent Toolkit is an open-source toolkit for portable, provider-agnostic agent tooling and workflows.

It helps you:

• define canonical agent assets once
• sync those assets across providers
• keep nested project AGENTS.md and CLAUDE.md files aligned with pointer, symlink, or hard-copy strategies
• use provider-agnostic CLI utilities and skills
• optionally run tracked, human-in-the-loop project workflows on top

Capability Layers

flowchart TD
  BASE["Provider Sync\ncanonical assets, drift, provider views"] --> TOOLS["CLI Utilities and Skills\nbootstrap, packs, docs tooling, diagnostics"]
  TOOLS --> FLOW["Optional Workflows\ntracked projects, reviews, PR flow"]

Loading

You can adopt any layer independently.

Quick Start

pnpm install
pnpm run cli -- help
pnpm run cli -- init --scope project
pnpm run cli -- status --scope all

Useful next commands:

• pnpm run cli -- sync --scope all
• pnpm run cli -- instructions validate --strategy symlink
• pnpm run cli -- tools install
• pnpm run cli -- docs init --app-name my-docs
• pnpm run cli -- config describe
• pnpm run cli -- config dump --json
• pnpm run cli -- project status --json
• pnpm run cli -- project list --json
• pnpm run cli -- project validate-plan --project-path <path>

For local repo development:

• pnpm build
• pnpm build:docs
• pnpm lint
• pnpm type-check
• pnpm test

Docs

Full documentation lives on the docs site:

• Docs Home
• Start Here
• Provider Sync
• Instruction Sync
• Agentic Workflows
• Docs Tooling
• CLI Utilities
• Reference
• Contributing

Repo Layout

• packages/cli - OAT CLI for provider sync, docs tooling, project utilities, and diagnostics
• packages/control-plane - read-only project-state library used by the CLI for structured OAT project status, listing, and recommendation data
• packages/docs-config - config helpers for OAT-powered Fumadocs apps
• packages/docs-theme - shared React components for OAT-powered Fumadocs apps
• packages/docs-transforms - remark plugins and transform bundle for OAT-powered Fumadocs apps
• apps/oat-docs - the OAT docs site
• .agents/skills - bundled OAT skills
• .oat - OAT templates, project artifacts, repo reference, and sync state

Packages

• @open-agent-toolkit/cli
• @open-agent-toolkit/control-plane
• @open-agent-toolkit/docs-config
• @open-agent-toolkit/docs-theme
• @open-agent-toolkit/docs-transforms