Tribal

A personal knowledge context engine for software development. Tribal captures learnings, debugging insights, heuristics, and decision rationale from development work, then makes that knowledge retrievable by coding agents via MCP (Model Context Protocol).

Prerequisites

• Rust (stable toolchain, 1.89+)
• Rust nightly (for rustfmt — rustup toolchain install nightly)
• Docker (for local Postgres and test containers)
• just — cargo install just
• sqlx-cli — cargo install sqlx-cli --no-default-features --features postgres
• cargo-deny — cargo install cargo-deny

Setup

git clone [email protected]:samfolo/tribal.git
cd tribal
just db-up
just db-migrate
just check
just test

Running

# Run the MCP server (stdio transport)
just serve

# Run with a specific project
just serve-project <project_id>

Development

# Format code (requires nightly rustfmt)
just fmt

# Lint and format check
just check

# Run all tests
just test

# Run unit tests only (no database required)
just test-unit

# Full pre-push check (format, lint, test)
just pre-push

# Regenerate sqlx offline query metadata
just sqlx-prepare

Licence

MIT