@codified/cli
v0.5.9
Published
Codify — Living Context Graph for AI-Native Teams
Downloads
5,050
Readme
@codified/cli
Living Context Graph for AI-Native Teams
Codify mines your project history into a structured context graph -- decisions, features, customer signals, code artifacts, and their relationships. Claude Code gets ambient access via MCP, so your AI assistant understands not just what your code does but why it was built that way.
Quick Start
npm install -g @codified/cli
cd your-project
export ANTHROPIC_API_KEY=sk-ant-...
codify upcodify up runs three steps in sequence -- infrastructure setup, git history mining, and MCP server launch. After it completes, open Claude Code. Codify connects automatically and Claude gains access to 23 MCP tools and 4 MCP resources covering your project's full context.
Prerequisites
- Node.js 22+
- Docker Desktop
ANTHROPIC_API_KEYenvironment variableVOYAGE_API_KEY(optional, enables semantic search via Voyage AI embeddings)
CLI Commands (30)
Setup
| Command | Description |
|---------|-------------|
| codify up | One-command setup and start (init + bootstrap + start) |
| codify init | Set up Docker services, run migrations, install MCP config |
| codify bootstrap | Mine git history into the context graph |
| codify start | Start the MCP server for Claude Code |
| codify project | Manage multiple projects (create, list, switch) |
Context and Search
| Command | Description |
|---------|-------------|
| codify search <query> | Search the context graph |
| codify explain <question> | Claude-powered narrative answer about your project |
| codify briefing <topic> | Synthesized context briefing on a topic |
| codify decide <question> | Assemble decision-point context (evidence, gaps, risks) |
| codify add | Record a decision, signal, or other context |
| codify graph | Visualize the context graph (Mermaid diagram) |
| codify check <file> | Check files for related context (CI-ready, exit 0/1) |
Gap Management
| Command | Description |
|---------|-------------|
| codify status | Show project health dashboard |
| codify gaps | Show gaps detected by the Gap Engine |
| codify triage | Interactively resolve gaps |
| codify collect | Mine the graph for evidence to fill gaps |
| codify evolve | Manage structural evolution proposals |
Connectors
| Command | Description |
|---------|-------------|
| codify connect | Connect external data sources (Slack, GitHub, Linear, Notion, docs) |
| codify connectors | List all connectors with health status |
| codify watch | Start continuous ingest polling with heartbeat |
Analytics
| Command | Description |
|---------|-------------|
| codify digest | Daily context digest -- graph growth, gaps, metabolism |
| codify metrics | Collection pipeline analytics |
| codify audit | Metabolism audit trail (decay, prune, promote events) |
Maintenance
| Command | Description |
|---------|-------------|
| codify refresh-freshness | Recalculate freshness scores for all nodes |
| codify timeline | Show what changed in the graph over time |
| codify cleanup | Fix legacy data quality issues |
| codify embed | Backfill embeddings for semantic search |
| codify export | Backup the graph to a JSON file |
| codify import | Restore the graph from a JSON backup |
| codify reset | Reset the context graph (drop all data) |
Run codify <command> --help for detailed options on any command.
MCP Tools (23)
When the MCP server is running, Claude Code gets access to 23 tools:
| Category | Tools |
|----------|-------|
| Search and Navigate | codify_get_context, codify_search, codify_traverse, codify_get_decision_trail, codify_explain, codify_get_context_package, codify_decision_context, codify_get_digest |
| Gap Engine | codify_get_gaps, codify_resolve_gap, codify_collect |
| Collection | codify_get_collection_plans, codify_get_collection_metrics |
| Metabolism | codify_get_metabolism_audit, codify_get_evolution_proposals, codify_execute_evolution |
| Graph Mutation | codify_add_context, codify_bootstrap, codify_status, codify_subscribe_events |
| Branching | codify_create_branch, codify_merge_branch, codify_list_branches |
Plus 4 MCP resources: codify://schema, codify://quickstart, codify://context/{topic}, codify://gaps/active.
Architecture
PostgreSQL as a single storage engine with Apache AGE (graph), pgvector (semantic search), NATS JetStream (events), and Redis (caching). TypeScript monorepo with 8 packages.
Links
License
MIT
