Configuration

Configure Codehabits analysis parameters, exclusions, and behavior through the config file, dashboard settings, or environment variables.

Configuration file

When you run codehabits enable, a configuration file is created at .codehabits/config.json. This file is committed to your repository and controls how analysis behaves.

.codehabits/config.json

{
  "version": "1.0.0",
  "analysis": {
    "lookback_months": 12,
    "min_prs_for_pattern": 10,
    "min_confidence": 0.7,
    "include_closed_prs": true
  },
  "ignore": {
    "files": [],
    "authors": ["dependabot[bot]", "renovate[bot]"],
    "labels": ["wip", "draft"]
  },
  "sync": {
    "auto_commit": false
  },
  "custom_rules": []
}

Analysis settings

Setting	Type	Default	Description
lookback_months	number	12	How many months of PR history to analyze. Longer lookback means more data but slower analysis.
min_prs_for_pattern	number	10	Minimum number of PRs required before a convention is reported. Prevents premature pattern detection.
min_confidence	number	0.7	Minimum confidence score (0.0–1.0) for a convention to be included. Lower values include more uncertain patterns.
include_closed_prs	boolean	true	Whether to analyze closed (not merged) PRs. Useful for anti-pattern detection from rejected PRs.

ℹDashboard vs config file

Settings can be modified in both the .codehabits/config.json file and the web dashboard settings page. The dashboard settings are stored server-side and used when the cloud pipeline runs. The local config file is used by CLI commands like codehabits check.

Exclusions

File patterns

Specify file patterns to exclude from analysis. These files won't be scanned and won't affect convention detection.

Default ignored patterns

node_modules/
dist/
.next/
coverage/
*.min.js

In the dashboard settings, enter one pattern per line. In the config file, use the ignore.files array.

Ignored authors

PR comments from these authors are excluded from analysis. This prevents bot-generated content from affecting pattern detection.

Default ignored authors

dependabot[bot]
renovate[bot]

Ignored labels

PRs with these labels are excluded from analysis. Useful for filtering out work-in-progress or draft PRs.

Default ignored labels

wip
draft

Dashboard settings

The web dashboard provides a settings page for each repository at /repo/[id]/settings. These settings are persisted server-side and used during cloud analysis.

Setting	Default	Description
Auto-sync on PR merge	Off	Enable automatic intelligence updates via GitHub Action
Include closed PRs	On	Analyze closed (not merged) PRs for anti-pattern detection
Lookback period	12 months	PR history lookback window
Minimum confidence	70%	Convention filtering threshold
Min PRs for pattern	10	Minimum evidence before reporting
Domain knowledge extraction	On	Build knowledge graph from PR discussions
Reviewer expertise tracking	On	Map reviewers to expertise areas
Ignored file patterns	node_modules/, dist/, ...	Files excluded from codebase scanning
Ignored authors	dependabot[bot], renovate[bot]	Authors excluded from PR analysis

Environment variables

Variable	Description
CODEHABITS_TOKEN	API token for CI/CD authentication. Takes precedence over stored CLI credentials.
GITHUB_TOKEN	GitHub personal access token for PR fetching. Required in CI for private repos.
CODEHABITS_API_URL	Override the codehabits API base URL. Default: https://codehabits.dev. Useful for self-hosted or development.
CODEHABITS_TELEMETRY_DISABLED	Set to 1 to disable CLI and MCP usage telemetry.
DO_NOT_TRACK	Standard opt-out for telemetry. Set to 1 to disable.
CODEHABITS_POSTHOG_KEY	Optional PostHog write-key override. A public project key is used by default.

Telemetry

codehabits collects usage telemetry via PostHog to understand how the CLI and MCP server are used and improve the product. No source code or intelligence content is ever collected. When you are logged in, events use the same user id as the dashboard. Telemetry events include:

CLI command usage (which commands are run)
Success/failure counts
Convention and PR counts (numeric only)
MCP tool name, duration, and error state (not arguments or results)
Platform, OS, and Node.js version

The MCP server makes a network call for telemetry only. To opt out of both CLI and MCP telemetry, set CODEHABITS_TELEMETRY_DISABLED=1 or DO_NOT_TRACK=1 in your environment.

Plans and limits

Feature	Free	Team
Public repositories	Unlimited	Unlimited
Private repositories	1	Unlimited
PR lookback	100 PRs	Unlimited
AI model	DeepSeek V4 Flash	DeepSeek V4 Flash
Team management	-	Included
Usage analytics	Basic	Full