[ /agents ]

Make your agent Codehabits-aware in one prompt.

Codehabits ships an MCP server, Agent Skills, and a machine-readable docs bundle so every coding agent - Cursor, Claude Code, Codex, Windsurf, Gemini CLI, GitHub Copilot - can pick up your team's conventions in seconds. Paste this prompt into your agent and it sets itself up.

One-shot setup prompt
You are setting up Codehabits for this repository.

1. Read https://codehabits.dev/llms.txt to learn what Codehabits is.
2. Run `npx @codehabits/cli enable` in this repo. It will open a browser for GitHub OAuth. Works with zero PR history (day-1 baseline from codebase, docs, stack, and git).
3. Run `npx @codehabits/cli mcp-install` to wire the Codehabits MCP server into this project (`.cursor/mcp.json`).
4. Read files under `.codehabits/` (including `map.json` if present) - those are the team's authoritative conventions, anti-patterns, domain knowledge, reviewer expertise, and heuristic repo map. Treat them as ground truth.
5. From now on:
   - When you write code, follow `.codehabits/conventions.json` and avoid `.codehabits/anti-patterns.json`.
   - Before exploring broadly, query `get_repo_map` or `get_change_routes` instead of dumping the whole tree into context.
   - When you need domain context, query the `get_knowledge` MCP tool first.
   - When you disagree with a convention, use the `record_feedback` MCP tool instead of silently ignoring it.
   - When suggesting reviewers for a change, use `suggest_reviewers`.

Report back: which files exist under `.codehabits/`, the top 5 conventions you found, and 1 anti-pattern (or baseline note) you should respect in this repo.
works withCursorClaude CodeCodexWindsurfGemini CLICopilot

[ what your agent gains ]

Eight tools your agent can call

The Codehabits MCP server exposes everything an agent needs to be team-aware. Tool names are stable; agents discover them via standard MCP introspection.

get_team_context

Read team intelligence

Pull the team's conventions, anti-patterns, domain knowledge, and reviewer expertise in one call. Use before writing or reviewing.

check_code

Validate a code snippet

Pass any snippet and get back violations against team conventions and anti-patterns, with suggestions for each.

get_knowledge

Look up domain knowledge

Query topic-specific knowledge captured from docs and PR discussions: auth, billing, deployment, schema decisions, runbooks.

suggest_reviewers

Pick the right reviewers

Given a set of changed files, return the contributors with the deepest expertise scored by history and reviews.

get_repo_map

Navigate with the repo map

Query the heuristic map (packages, entrypoints, subsystems, hot files) instead of exploring the whole tree into context.

get_change_routes

Find related change routes

Given a path or prefix, return directories and files that often change together from git co-change heuristics.

record_feedback

Capture disagreements

When the user (or you) overrides a convention, propose the change. Lands in .codehabits/proposals.json (gitignored) for review.

approve_proposal

Promote proposals

Merge an approved proposal into conventions.json and regenerate the Agent Skills markdown. Creates tracked git changes.

[ wire up the mcp server ]

One config. Every agent.

The Codehabits MCP server speaks standard MCP. The same JSON works in every agent that supports the protocol. Drop it into the right file and restart.

Universal MCP config· json
{
  "mcpServers": {
    "codehabits": {
      "command": "npx",
      "args": ["-y", "@codehabits/mcp"]
    }
  }
}
C
Cursor
.cursor/mcp.json
npx @codehabits/cli mcp-install

Per-project. Add --global for ~/.cursor/mcp.json.

A
Claude Code
~/.claude/mcp.json
claude mcp add codehabits npx -y @codehabits/mcp

Built-in MCP CLI. Restart Claude Code to pick it up.

X
Codex CLI
~/.codex/mcp.json
Drop the universal config into ~/.codex/mcp.json

Codex reads MCP servers at startup; restart after editing.

W
Windsurf
~/.codeium/windsurf/mcp_config.json
Drop the universal config into ~/.codeium/windsurf/mcp_config.json

Reload Windsurf settings or restart to activate.

G
Gemini CLI
~/.gemini/settings.json
Drop the universal config into ~/.gemini/settings.json

Place under the mcpServers key alongside other servers.

H
GitHub Copilot
.agents/skills/codehabits-team-intel/
Reads .agents/skills/ and AGENTS.md - no extra config

Discovers team intelligence via .agents/skills/ (default) and AGENTS.md. Optional MCP for active checks.

[ machine-readable resources ]

Built for agents to crawl

Codehabits ships an llms.txt index and a bundled full-docs file so any agent can ingest the entire product surface area without HTML parsing.

/llms.txtOpen

Short, machine-readable index for any LLM to discover Codehabits.

/llms-full.txtOpen

Full bundled docs - CLI, MCP, file schema, agent setup - in one markdown file.

@codehabits/clinpm ↗

The CLI that extracts intelligence from your codebase and PR history and writes .codehabits/.

@codehabits/mcpnpm ↗

Official MCP Registry: io.github.codehabits-dev/codehabits-mcp. Eight tools, zero config beyond pointing your agent at it.

GitHub sourceGitHub ↗

Open source monorepo. CLI, MCP server, web app, schemas.

Agent Skills specSpec ↗

The open standard Codehabits builds on. Agent-tool agnostic.

First, give your agent a repo to learn from.

The bootstrap prompt above assumes a Codehabits-enabled repo. If this is your first time, run enable yourself once - then any agent can pick it up automatically.