Tribe

Tribe v2 is a profile-scoped control plane for multi-agent work in Codex. It takes task ownership, dependencies, agent lifecycle, and result evidence out of chat history and keeps them in state that survives individual sessions.

The current 2.0.0-alpha.4 version is built as one Rust workspace and one deployable binary. PostgreSQL with pgvector, Docker, MCP, and skills are mandatory parts of the core. There is no database-free v2 mode, and the project remains an alpha rather than a production service.

Two layers of state

Each project retains its AGENTS.md and local .agents/ directory. They define rules, responsibility boundaries, handoff format, and evidence requirements. The profile-scoped control plane stores the state that must remain available across sessions in PostgreSQL: projects, memory, the task graph, and agent lifecycle.

Codex reaches this state through Rust MCP. A local stdio adapter connects MCP to the Codex client, while the HTTP process exposes separate health and readiness probes. /readyz succeeds only after DATABASE_URL is reachable and the embedded migrations have completed.

Task graph and agent lifecycle

Work is represented as an explicit graph. A task node has an owner and phase, while a handoff connects the producer, consumer, and evidence revision. Idempotent commands allow a request to be repeated safely after a failure without creating a duplicate.

Agent lifecycle is recorded in the control plane as well: registration, heartbeat, participant messages, and result return. Profile and project scopes are separate, so shared profile rules and memory do not mix the state of individual projects. A new session restores current tasks, owners, and the next allowed action instead of trying to infer them from the full text of an earlier conversation.

What the alpha provides

The current version supports profile and project scopes, PostgreSQL/SQLx persistence, the task graph, scoped memory, agent registration and heartbeat, messages, handoffs, and result return. Installation adds the central root skill and five specialized skills, for six profile skills in total.

The alpha boundary is deliberately narrow. It has no production authentication or RBAC, no graph UI, no live Codex/OpenAI provider, no SSE timelines, and no production observability. Local contracts use a deterministic FakeProvider. Compose is intended for local evaluation, and the HTTP port must not be exposed to an untrusted network.

Tribe is released under the MIT license.