Skip to main content

Install

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

Environment

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.
What gets written:
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 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.

enagrams status

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

enagrams watch

Full-screen live dashboard that auto-refreshes every second. Same content as status but persistent.
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.
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 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.