# Codehabits

> Codehabits extracts your team's coding conventions, anti-patterns, and domain knowledge from PR history and delivers them to every AI coding agent via the Agent Skills open standard and a dedicated MCP server.

Codehabits gives AI agents (Cursor, Claude Code, Codex, Windsurf, Gemini CLI, GitHub Copilot, etc.) team-aware context. Run `npx @codehabits/cli enable` in a repo and it analyzes git/PR history to produce a `.codehabits/` directory containing `conventions.json`, `anti-patterns.json`, `knowledge.json`, `reviewers.json`, and `meta.json`. An MCP server (`@codehabits/mcp`, bin: `codehabits-mcp`) exposes that intelligence as 6 tools.

## Setup

- [Quickstart](https://codehabits.dev/docs/quickstart): one-command setup, OAuth, enable
- [Concepts](https://codehabits.dev/docs/concepts): how Codehabits works under the hood
- [CLI reference](https://codehabits.dev/docs/cli): every command and flag
- [Configuration](https://codehabits.dev/docs/configuration): rules, ignores, scoring
- [Dashboard](https://codehabits.dev/docs/dashboard): web app for teams
- [Agents](https://codehabits.dev/agents): agent-facing setup with one-shot prompt

## MCP server

- Package: `@codehabits/mcp` (bin: `codehabits-mcp`)
- Tools: `get_team_context`, `check_code`, `get_knowledge`, `suggest_reviewers`, `record_feedback`, `approve_proposal`
- Auto-install for Cursor: `npx @codehabits/cli mcp-install` (writes `.cursor/mcp.json`; add `--global` for `~/.cursor/mcp.json`)
- Universal MCP config: `{"mcpServers":{"codehabits":{"command":"npx","args":["-y","@codehabits/mcp"]}}}`

## Bootstrap prompt

Paste this into any agent to make it Codehabits-aware:

```
You are setting up Codehabits for this repository.
1. Read https://codehabits.dev/llms.txt
2. Run `npx @codehabits/cli enable` in this repo
3. Run `npx @codehabits/cli mcp-install` to wire the MCP server
4. Read every file under `.codehabits/` - those are the team's authoritative conventions
5. Use `record_feedback` whenever you disagree with a convention; never silently ignore one
Report what you found in `.codehabits/`.
```

## Resources

- [Full bundled docs](https://codehabits.dev/llms-full.txt): every doc page concatenated for ingestion
- [Agent Skills spec](https://agentskills.io): the open standard Codehabits builds on
- [GitHub source](https://github.com/codehabits-dev/codehabits): open source monorepo
- [npm @codehabits/cli](https://www.npmjs.com/package/@codehabits/cli)
- [npm @codehabits/mcp](https://www.npmjs.com/package/@codehabits/mcp)

## Recent writing

- [Why we built Codehabits](https://codehabits.dev/blog/why-codehabits): Every team has habits: the small, repeated patterns that make code feel like yours. We built Codehabits to extract those habits and ship them to every AI tool your team uses.
- [What's New: Team Workspaces, Split Intelligence, and MCP Feedback](https://codehabits.dev/blog/whats-new-april-2026): Team dashboards, .codehabits split files, merge pipeline updates, MCP tools to record feedback and approve proposals, and refreshed docs. Here’s what shipped recently.
- [Introducing codehabits: Team Intelligence That Every AI Tool Auto-Discovers](https://codehabits.dev/blog/introducing-codehabits): One command extracts your team's coding conventions, anti-patterns, and domain knowledge from PR history - then delivers it to Cursor, GitHub Copilot, Claude Code, and 20+ AI tools automatically.
- [What Are Agent Skills? The Open Standard for AI Coding Tools](https://codehabits.dev/blog/what-are-agent-skills): Agent Skills solve the fragmentation problem across Cursor, Copilot, Claude Code, Codex, and Windsurf by giving every AI tool a shared way to discover team-specific coding intelligence.
- [How to Make Cursor, GitHub Copilot, and Claude Code Follow Your Team's Conventions](https://codehabits.dev/blog/ai-coding-tools-team-conventions): A practical guide to configuring every major AI coding tool - Cursor, GitHub Copilot, Claude Code, Codex, Windsurf, Gemini CLI - to respect your team's patterns, or automating the entire process with codehabits.

## Optional

- [Why we built Codehabits](https://codehabits.dev/blog/why-codehabits)
- [Pricing](https://codehabits.dev/pricing)
- [Changelog](https://codehabits.dev/changelog)