Crate ai_crew_sync 

Shared coordination bus for a team of AI coding agents (Claude Code, Codex, Cursor — any MCP client).

The crate is split so integration tests can drive the real HTTP surface:

• store holds all business logic and every SQL statement,
• tools is a thin MCP layer over it,
• serve wires the transport, authentication and axum together,
• admin is the operator CLI (teams, agents, tokens),
• admin_api is the remote administration surface at /admin/*,
• admin_cli drives it from the operator’s machine (admin …),
• context resolves which bus, token and project a client should use,
• proxy is the per-conversation stdio MCP server (mcp proxy),
• hook is what lifecycle hooks run (context hook).

Modules

admin

Operator-facing commands. These bypass MCP entirely and talk to Postgres directly. They remain the emergency path and the only way to bootstrap the first administrative credential; day-to-day administration goes through the remote API with ai-crew-sync admin ….

admin_api

Remote administration: /admin/*.

admin_cli

ai-crew-sync admin … from the operator’s own machine.

auth

client

Console client: everything the MCP tools can do, from a human terminal.

context

Local connection context: which bus, as whom, for which project.

dashboard

Read-only HTML dashboard for humans: who is online, what is claimed, what the channels are saying. Served by the bus itself at /dashboard.

error

events

In-process event hub fed by Postgres LISTEN/NOTIFY.

hook

ai-crew-sync context hook --binding <id> --event <event>.

model

Wire types returned by the MCP tools.

proxy

ai-crew-sync mcp proxy: a local stdio MCP server that forwards every tool call to the remote bus as one agent in one session.

ratelimit

Per-token request rate limiting for the MCP surface.

recipes

The team’s procedures over the bus tools, as prose any MCP host can follow. The files live in recipes/; the Claude Code plugin’s slash commands are generated from them (plugin/scripts/recipes.py), and this module embeds them so ai-crew-sync recipes <name> prints one on a machine that has the binary and not the repository.

serve

spool

The proxy’s durable reference spool.

store

tools

webhooks

Outgoing webhooks: forward team-visible bus events to Slack, Discord or a generic JSON endpoint, so humans see what the agents are doing without opening anything.

Statics

MIGRATOR

Embedded schema migrations, applied by migrate and on startup.