cafleet

CAFleet

https://github.com/user-attachments/assets/a66620cb-4a81-4525-95f2-1f1f22765288

Agent Teams reinvented for collaborative coding supporting Claude Code and Codex, with full code transparency.

Install

CAFleet works with two coding agents: claude (Claude Code) and codex (OpenAI Codex CLI). Install the plugin in whichever one you use — the broker CLI is shared.

Install CAFleet skills

Claude Code

Run the following commands on your terminal:

/plugin marketplace add himkt/cafleet
/plugin install cafleet@cafleet

[!IMPORTANT]

Make sure whether the skills are correctly installed. You can see available skills by running /skills on Claude Code prompt.

Typically, the config entries like following would be written in ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "Bash(cafleet *)",
      "Skill(cafleet:agent-team-monitoring)",
      "Skill(cafleet:agent-team-supervision)",
      "Skill(cafleet:base-dir)",
      "Skill(cafleet:cafleet)",
      "Skill(cafleet:create-figure)",
      "Skill(cafleet:design-doc)",
      "Skill(cafleet:design-doc-create)",
      "Skill(cafleet:design-doc-execute)",
      "Skill(cafleet:design-doc-interview)",
      "Skill(cafleet:my-slidev)",
      "Skill(cafleet:research-presentation)",
      "Skill(cafleet:research-report)"
    ],
    "ask": [
      "Bash(cafleet * member exec *)"
    ]
  },
  "enabledPlugins": {
    "cafleet@cafleet": true
  },
  "extraKnownMarketplaces": {
    "cafleet": {
      "source": {
        "source": "github",
        "path": "himkt/cafleet"
      }
    }
  }
}

Codex

Run the following command on your terminal

codex plugin marketplace add himkt/cafleet

[!IMPORTANT]

Make sure whether the skills are correctly installed. You can see available skills by running /skills on Codex prompt.

Typically, the config entries like following would be written in ~/.codex/config.toml:

[marketplaces.cafleet]
last_updated = "2026-05-16T11:56:51Z"
last_revision = "03a8caa66c8a7981345d74fe3aec9a6e498792a1"
source_type = "git"
source = "https://github.com/himkt/cafleet.git"

[plugins."cafleet@cafleet"]
enabled = true

[!IMPORTANT] Codex members need the cafleet DB directory to be writable from inside the codex sandbox. Add it to sandbox_workspace_write.writable_roots in any config.toml codex reads (e.g. ~/.codex/config.toml):

[sandbox_workspace_write]
writable_roots = ["/home/<you>/.local/share/cafleet"]

Use the absolute path matching CAFLEET_DATABASE_URL or the default XDG location.

[!TIP]

Recommended Codex rules for cafleet commands — drop into your codex rules file (e.g. ~/.codex/rules/cafleet.rules) to auto-approve the broker CLI while keeping cafleet member exec (which runs arbitrary shell on a member pane) gated behind a prompt:

prefix_rule(
    pattern = ["cafleet"],
    decision = "allow",
    justification = "All cafleet subcommands are allowed by default",
)

prefix_rule(
    pattern = ["cafleet", "member", "exec"],
    decision = "prompt",
    justification = "cafleet member exec runs arbitrary commands on a member; require approval",
)

For codex CLI version pin and operational specifics, see docs/codex-members.md.

Install CAFleet CLI (required for CAFleet to function)

uv tool install cafleet     # or: pip install cafleet
cafleet db init             # apply schema migrations (idempotent; rerun after upgrades)

The default database is ~/.local/share/cafleet/registry.db. Override with CAFLEET_DATABASE_URL (use an absolute path — SQLAlchemy does not expand ~ in SQLite URLs).

Simple example to use CAFleet

Provide the following prompt to Claude Code or Codex to see how it works.

I want to see how cafleet works.
Please create a fresh team with two teammates using cafleet and let them ping-pong each other.
After the demonstration, please shutdown the team.

Real world usage; Design-doc-driven development

CAFleet provides the builtin skills for Spec Driven Development (SDD). We're using CAFleet to develop CAFleet!

Claude Code:

/cafleet:design-doc-create I want to create a simple TUI calculator

Codex:

$cafleet:design-doc-create I want to create a simple TUI calculator

You can see the existing design docs on design-docs/, which are actually created by the skills.

CLI cheatsheet