Skip to main content

​
Install

npm install -g enagrams
Or invoke via npx enagrams <command> — no install required. enagrams init will offer to install globally after first auth.

​
Environment

VariablePurposeDefault
ENAGRAMS_API_KEYYour API key (also stored in ~/.config/enagrams/config.json)—
ENAGRAMS_WORKSPACEWorkspace slug or ID (usually set in .env by init)—
ENAGRAMS_API_URLAPI serverhttp://localhost:3001
ENAGRAMS_WEB_URLWeb dashboardhttp://localhost:3000
The API key is written once to ~/.config/enagrams/config.json and reused across every repo. The workspace slug lives in each repo’s .env.

​
Commands

​
enagrams init

Bootstrap the current repo. Runs browser-based device auth, creates or resumes a workspace, writes all config files, and optionally installs the CLI globally. 
npx enagrams init
What gets written: 
~/.config/enagrams/config.json   API key (global)
.env                              ENAGRAMS_WORKSPACE=<slug>
.cursor/mcp.json                  MCP server config for Cursor
.cursor/hooks.json                Cursor hook wiring
.cursor/hooks/enagrams-hooks.mjs  Shared hook script (all IDEs)
.mcp.json                         MCP server config for Claude Code
.claude/settings.json             Claude Code hooks
.codex/hooks.json                 Codex hooks
Re-running init is safe — existing files are updated in place.

​
enagrams login

Re-authenticate without touching the workspace. Writes ~/.config/enagrams/config.json. 
enagrams login

​
enagrams join

Join an existing workspace in the current repo. Lists the workspaces you’re a member of (or have been invited to) and writes the same config files as init. 
npx enagrams join

​
enagrams status

Show live team status: active agents, current file reservations, recent decisions and learnings. 
enagrams status

​
enagrams watch

Full-screen live dashboard that auto-refreshes every second. Same content as status but persistent. 
enagrams watch
Ctrl+C to exit. Also available as enagrams status --watch.

​
enagrams learn <text>

Record a learning for the team. Calls the learn MCP tool directly so the insight is available to every agent on their next sync. 
enagrams learn "Rate limiter resets at UTC midnight, not wall-clock"
With no text, prompts interactively.

​
enagrams compile-rules

Pulls recent learnings from your workspace and compiles them into .cursor/rules/team-learnings.mdc. Cursor will load them as project rules so every agent session starts with the team’s accumulated wisdom. 
enagrams compile-rules

​
enagrams help

Usage summary. Aliases: --help, -h.

​
Flags

​
--mcp

Launch the MCP server over stdio. Used by your IDE’s MCP configuration — you should not normally invoke this by hand. init writes the right command into .cursor/mcp.json and .mcp.json automatically. 
{
  "mcpServers": {
    "enagrams": {
      "command": "npx",
      "args": ["-y", "enagrams", "--mcp"],
      "env": {
        "ENAGRAMS_API_KEY": "...",
        "ENAGRAMS_WORKSPACE": "..."
      }
    }
  }
}