@codehabits/cli

codehabits

Team intelligence for AI coding agents. Extract conventions, anti-patterns, and domain knowledge from your codebase and PR history - then deliver it to Cursor, Claude Code, and other AI tools.

Quick start

npx @codehabits/cli login
npx @codehabits/cli enable

This scans your repo, analyzes PR history with AI, and generates:

• .codehabits/conventions.json, .codehabits/anti-patterns.json, .codehabits/knowledge.json, .codehabits/reviewers.json, .codehabits/meta.json: structured team intelligence (split files)
• .codehabits/config.json: analysis settings (safe to edit)
• .codehabits/proposals.json: optional; gitignored; MCP record_feedback / approve_proposal only
• .cursor/skills/codehabits-team-intel/: Agent Skill for Cursor
• AGENTS.md: entry point for Claude Code and similar tools

Repositories under a GitHub organization must be assigned to a team when you first enable them (interactive flow, or npx @codehabits/cli enable --team <team-id-or-slug>). --personal is only for user-owned repos. In CI, always pass --team for org repos.

Commands

Command	Description
codehabits login	Authenticate with GitHub OAuth
codehabits enable	Scan repo and generate intelligence (--team, --personal, --path, --skip-prs)
codehabits sync	Incrementally update with latest PRs (merges with cloud using same rules as local)
codehabits team assign	Assign the current repo to a team (--team for non-interactive)
codehabits show <type>	Display conventions, anti-patterns, knowledge, or reviewers
codehabits check <file>	Validate a file against team conventions
codehabits mcp-install	Set up MCP server for Cursor
codehabits setup-action	Generate GitHub Actions workflow for auto-sync
codehabits token create	Create API token for CI/CD

CI/CD

Sync (after the repo is already enabled, typical GitHub Action on merge):

- name: Sync codehabits intelligence
  run: npx @codehabits/cli@latest sync --ci
  env:
    CODEHABITS_TOKEN: ${{ secrets.CODEHABITS_TOKEN }}
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

First-time enable in CI for an organization repo requires a team (non-interactive):

npx @codehabits/cli@latest enable --team your-team-slug

Install globally

npm install -g @codehabits/cli
codehabits enable

After global install, the command is just codehabits (not @codehabits/cli).

Documentation

Full docs at codehabits.dev/docs

License

MIT