Extract team conventions from git history. Serve them to any AI coding tool via MCP.
Quick Start · Setup AI Tool · Modes · MCP Tools
Three commands. Zero API keys. Works with Claude Code, Cursor, Codex, Copilot, and 10+ more.
pip install kronode
kronode init .
kronode ingest
kronode serve
What it does
Kronode reads your local git repository and extracts:
- Conventions — commit message patterns, team naming rules, directory structure
- Documentation — README, docs/, architecture decisions from markdown files
- PR review knowledge — what reviewers actually teach in code reviews (optional)
Then serves it all via MCP to any AI coding tool — so your AI assistant knows your team's patterns, not just generic best practices.
Quick Start
# Install
pip install kronode
# Point to your repo
cd ~/projects/your-repo
kronode init .
# Extract conventions + docs from git history
kronode ingest
# Optional: also fetch PR review comments (uses gh CLI auth)
kronode ingest --with-prs
# Start MCP server
kronode serve
Then connect your AI tool (see Setup below).
How it works
Your Git Repo Kronode AI Coding Tool
┌──────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ git log │────▸│ Convention │ │ Claude Code │
│ git blame │ │ Extraction │ │ Cursor │
│ docs/*.md │────▸│ │◂───▸│ Codex │
│ PR reviews │────▸│ SQLite DB │ MCP │ Copilot │
│ (optional) │ │ Local Embeddings │ │ Windsurf │
└──────────────┘ └──────────────────┘ │ + 7 more │
└──────────────────┘
Everything runs locally. No data leaves your machine unless you opt into BYOK mode.
CLI Reference
| Command | Description |
|---|---|
kronode init . |
Initialize for a local repo |
kronode ingest |
Extract conventions + docs from git history |
kronode ingest --with-prs |
Also fetch PR review comments (uses gh CLI or --token) |
kronode serve |
Start MCP server (stdio) |
kronode serve --http |
Start MCP server (HTTP/SSE for Cursor, remote) |
kronode query "task" -f file.py |
Test context retrieval from terminal |
kronode setup <tool> |
Print MCP config for an AI tool |
kronode status |
Show convention/doc counts |
kronode add "convention rule" |
Manually add a convention |
kronode purge |
Delete all ingested data |
Setup Your AI Tool
Claude Code
claude mcp add kronode -- kronode serve
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"kronode": {
"command": "kronode",
"args": ["serve"]
}
}
}
OpenAI Codex
Add to ~/.codex/config.toml:
[mcp_servers.kronode]
command = "kronode"
args = ["serve"]
[mcp_servers.kronode.tools.get_context]
approval_mode = "approve"
[mcp_servers.kronode.tools.get_doc]
approval_mode = "approve"
GitHub Copilot (VS Code)
Add to .vscode/mcp.json:
{
"servers": {
"kronode": {
"command": "kronode",
"args": ["serve"]
}
}
}
Run kronode setup --list to see all supported tools.
Modes
Local Mode (default)
Zero API keys, zero network. Reads from your .git/ directory.
- Conventions from commit message patterns + git structure
- Documentation from markdown files
- Local embeddings via fastembed (ONNX, ~50MB)
Local + PRs
Add --with-prs to also fetch PR review comments. If gh CLI is installed and authenticated, no token needed. Otherwise pass --token <PAT>.
# With gh CLI (recommended)
gh auth login
kronode ingest --with-prs
# Or with explicit PAT
kronode ingest --with-prs --token ghp_xxx
BYOK Mode
Set OPENAI_API_KEY for richer LLM-based convention extraction from PR diffs.
OPENAI_API_KEY=sk-xxx kronode ingest --with-prs
Configuration
Copy .env.example to ~/.kronode/.env:
# Number of PRs to analyze (default: 200)
KRONODE_PR_COUNT=200
# Minimum confidence threshold (default: 0.5)
KRONODE_MIN_CONFIDENCE=0.5
# Max conventions per query (default: 20)
KRONODE_MAX_CONVENTIONS=20
MCP Tools
Kronode exposes 2 MCP tools:
get_context
Returns everything an AI needs before coding:
- Top conventions ranked by file-level relevance (with match reasons)
- Related documentation from repo markdown
- Action plan summary
- Directly and loosely related issues (if indexed)
get_doc
Returns the full content of a documentation page when get_context returned a truncated snippet.
Tech Stack
- Python 3.11+ — async throughout
- SQLite — zero-config local database (PostgreSQL optional)
- fastembed — ONNX local embeddings (~50MB, not 2GB PyTorch)
- MCP — Model Context Protocol for AI tool integration
- click + rich — CLI framework
Development
git clone https://github.com/GauravGill90/kronode.git
cd kronode
uv venv .venv && source .venv/bin/activate
uv pip install -e ".[byok]"
kronode --help
License
MIT
Metadata
Release files for kronode 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| kronode-0.2.0.tar.gz | 57.3 kB | Without provenance | Details for kronode-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| kronode-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for kronode-0.2.0-py3-none-any.whl |
Total release size: 129.3 kB
Release files / kronode-0.2.0.tar.gz
| Download URL | kronode-0.2.0.tar.gz |
|---|---|
| Size | 57.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6a1122f502baf22a77232d41929daa719e106a0b4878cd2b7e98c316eace859c
|
|
BLAKE2b-256 checksum How to use checksums |
98a5527000929f53023d20c04c84ab6f06670e4bfe208eae4842043daaf80f9b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / kronode-0.2.0-py3-none-any.whl
| Download URL | kronode-0.2.0-py3-none-any.whl |
|---|---|
| Size | 71.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
904f2db0ecd9e75de72df8e08efd58e042ce573f8ad921dc3a77bb7a9b224762
|
|
BLAKE2b-256 checksum How to use checksums |
d26476b0704ab271f0f0141df876d5f9336bbb718b0d1005ef9ec577f69239a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.6 {"installer":{"name":"uv","version":"0.10.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for kronode 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.