kalikot26

Fleet Bus — AI skill for Claude Code

AI community

A tiny file-based message bus that lets AI coding agents (Claude Code, Codex CLI, Grok, or any tool with a shell) hand off tasks, report back, and wake each other on one machine.

How to install Fleet Bus

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kalikot26/Fleet-Bus and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Fleet Bus does

A tiny file-based message bus that lets AI coding agents (Claude Code, Codex CLI, Grok, or any tool with a shell) hand off tasks, report back, and wake each other on one machine. One Node.js file, zero dependencies.

Alternatives in AI

  • Agent Teams AI — You're the boss, agents are your team 2k ★
  • UltraCode Shim — Give Claude Code's ultracode mode to ANY model you already pay for 422 ★
  • Hcom — Let AI agents message, watch, and spawn each other across terminals 216 ★

README

Fleet Bus

**A tiny, file-based message bus that lets AI coding agents talk to each other on one machine.**

Run Claude Code in one window, Codex CLI in another, and a Grok bot or your own script in a third. With Fleet Bus they can hand each other tasks, report results, broadcast rules, and wake each other up. There is no server, no daemon, no database, no MCP server and no account. It is one Node.js file with zero dependencies, plus a folder of JSON files.

Any agent that can **run a shell command** and **read its output** can join, whichever vendor or model it comes from.

 ┌──────────────┐   send --to builder-a    ┌──────────────┐
 │ Claude Code  │ ───────────────────────▶ │  Codex CLI   │
 │ (lane: main) │                          │ (lane: bldr) │
 │              │ ◀─────────────────────── │              │
 └──────────────┘   send --to main         └──────────────┘
        │   ▲             (report)                 │
        ▼   │                                      ▼
   ~/.claude/fleet/main/inbox/*.json      ~/.claude/fleet/builder-a/inbox/*.json

Why

Once you run several AI coding sessions in parallel, for example one per git worktree or one per task, they need to coordinate:

  • An orchestrator session hands a bounded task to a builder session and gets a report back.
  • A rule changes (a new branch policy, a new model to use), and every running session needs to hear it once.
  • A session finishes a milestone (a PR merged, a deploy done), and the others must rebase or react.
  • A session is waiting on another one and should wake up when the answer lands, instead of polling in chat.

Chat-level "send a message to the other conversation" features only work inside one app, and usually only while the target is open. Fleet Bus is vendor-neutral and durable. Messages sit on disk until the receiving lane reads them, even when it is closed.

How it works

Lanes

A **lane** is a mailbox that one agent session owns. By default a lane's