No description
  • Rust 65.6%
  • Python 31.4%
  • PLpgSQL 1.5%
  • Shell 1.1%
  • Starlark 0.3%
  • Other 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-04 00:39:30 +00:00
.agent chore: harden local Tribe MCP development workflow 2026-09-20 22:03:56 +03:00
.agents Keep Tribe advisory and reuse persistent native hook server 2026-11-02 06:54:03 +03:00
agents Initial public Tribe release 2026-09-20 02:14:39 +03:00
assets Keep Tribe advisory and reuse persistent native hook server 2026-11-02 06:54:03 +03:00
bin feat: make Tribe bootstrap capability-aware and restart-safe 2026-09-23 03:03:42 +03:00
crates Fix native installation routing and actionable coordination errors 2026-11-04 00:31:21 +00:00
docs Keep Tribe advisory and reuse persistent native hook server 2026-11-02 06:54:03 +03:00
integrations/codex Update Tribe lifecycle and Codex integration 2026-09-27 15:16:18 +03:00
migrations Integrate native Tribe service and authoritative failover storage 2026-11-04 00:58:08 +03:00
references Fix native installation routing and actionable coordination errors 2026-11-04 00:31:21 +00:00
scripts Retire legacy TOML hooks during native installation 2026-11-04 00:39:30 +00:00
skills Keep Tribe advisory and reuse persistent native hook server 2026-11-02 06:54:03 +03:00
src feat: make Tribe bootstrap capability-aware and restart-safe 2026-09-23 03:03:42 +03:00
tests Retire legacy TOML hooks during native installation 2026-11-04 00:39:30 +00:00
.dockerignore Release Tribe 1.0.0-alpha.1 control plane 2026-09-20 16:56:49 +03:00
.env.dev.example feat: complete Tribe v2 profile runtime and durable MCP 2026-09-22 13:30:07 +03:00
.gitignore feat: add durable coordination control plane 2026-09-24 05:07:31 +03:00
.gitmodules chore: harden local Tribe MCP development workflow 2026-09-20 22:03:56 +03:00
AGENTS.md Keep Tribe advisory and reuse persistent native hook server 2026-11-02 06:54:03 +03:00
BUILD.bazel Integrate native Tribe service and authoritative failover storage 2026-11-04 00:58:08 +03:00
Cargo.lock Lock dependencies for native HTTP MCP transport 2026-11-02 07:09:55 +03:00
Cargo.toml Fix native Tribe MCP compilation on pinned time features 2026-11-04 01:10:12 +03:00
CHANGELOG.md feat: make Tribe bootstrap capability-aware and restart-safe 2026-09-23 03:03:42 +03:00
CLAUDE.md Vendor pinned OSS Agent Playbook 2026-09-20 08:57:12 +03:00
docker-compose.dev.yml feat: complete Tribe v2 profile runtime and durable MCP 2026-09-22 13:30:07 +03:00
docker-compose.yml Update native lifecycle coordination and scoped task handling 2026-10-13 11:09:16 +03:00
Dockerfile Release Tribe 1.0.0-alpha.1 control plane 2026-09-20 16:56:49 +03:00
install.sh Fix native installation routing and actionable coordination errors 2026-11-04 00:31:21 +00:00
LICENSE Initial public Tribe release 2026-09-20 02:14:39 +03:00
PROJECT_AGENT_CONTEXT.md feat: add durable coordination control plane 2026-09-24 05:07:31 +03:00
pyproject.toml feat: make Tribe bootstrap capability-aware and restart-safe 2026-09-23 03:03:42 +03:00
README.md Integrate native Tribe service and authoritative failover storage 2026-11-04 00:58:08 +03:00
SKILL.md Fix native installation routing and actionable coordination errors 2026-11-04 00:31:21 +00:00
uv.lock feat: make Tribe bootstrap capability-aware and restart-safe 2026-09-23 03:03:42 +03:00

Tribe

Tribe is the native coordination and memory layer shipped with the patched Codex client. Its Rust service owns durable objectives, roles, agent identity, task graphs, backlog, policy, messages, and scoped memory. PostgreSQL and pgvector hold the authoritative state. The Codex runtime calls this service in process through the Tribe native module; model-facing MCP, prompt instructions, and shell hooks are not the primary execution path.

The source is pinned as the vendor/tribe Git submodule of codex-patched. The native module and the patched Core host are released together. A supported installation uses the patched client and its matching module catalog. An unpatched Codex binary is not a Tribe runtime.

Native contract

Codex Core supplies trusted thread, execution environment, workspace URI, and lifecycle event identities. The module uses them to register or resolve the profile and project scope and to start or resume the root objective on the first user turn or first explicit goal. It records spawn reservation and binding, worker reports and stops, accepted goal changes, and turn context through direct Rust service calls. Paused, completed, or cleared goals suspend new dispatch. The model sees bounded authoritative state and can call typed native tools for explicit task, roster, message, and memory operations.

The direct service entry point is crates/tribe-mcp/src/native.rs. It reuses the semantic business methods and PostgreSQL repositories already used by the RMCP adapter. The RMCP adapter remains a development transport for protocol inspection; it is not part of the normal Codex runtime route. The native module lives in the codex-patched source tree.

Native memory lookup supports scoped PostgreSQL text search. Vector nearest-neighbor lookup uses pgvector when a 1536-dimensional embedding is supplied; the native service does not synthesize an embedding or claim that text lookup used a vector model. Deadline scheduling and cancellation are durable. Due deadlines appear in bounded turn context; delivery to an idle thread requires the host wakeup callback.

Persistence and availability

PostgreSQL is mandatory for authoritative Tribe state. Native work that cannot obtain a confirmed state returns an explicit unavailable or unknown result. Ordinary Codex work can continue when Tribe infrastructure is unavailable; it must not claim a completed Tribe mutation. The local authority ledger and replay code are in crates/tribe-persistence. Remote replay, conflicts, and snapshots retain event evidence and revision checks.

Secrets belong in the runtime's private configuration. Do not put database credentials, session contents, private memory, or native identity tokens into Git or model-visible status.

Source layout

Path Purpose
crates/tribe-mcp/src/native.rs Direct typed native service facade
crates/tribe-mcp/src/native_features.rs Pool, deadline, and memory search operations
crates/tribe-mcp/src/native_tasks.rs, native_agents.rs, native_plan.rs Shared live and replay transaction bodies
crates/tribe-mcp/src/semantic.rs Stable semantic request and response types
crates/tribe-persistence/ PostgreSQL repositories, authority ledger, local database support
migrations/ Embedded schema migrations
.agents/ Static role and project guidance

The release build and runtime checks run through the remote runner documented in the parent codex-patched repository. Do not compile the client or Tribe locally on the operator laptop.