pip install llm-context-router

Scope your AI context
before it explodes.

A minimal CLI tool that routes AI coding tasks to the right agent and scopes the prompt to only the relevant files.
No LLM calls. No automation. No magic.

$ pip install llm-context-router

View on GitHub View on PyPI

// the problem

The problem with AI coding tools

Before

You ask: "fix the auth bug"

→ AI loads 847 files

→ touches 6 modules it shouldn't

→ breaks unrelated code

→ costs you 40k tokens

After (with llm-context-router)

$ llm-context-router ask "fix the auth bug" \
--file src/auth/token.py

Agent: backend

Files: src/auth/token.py, src/auth/session.py

Prompt: Touch only these files.

Do not modify: src/api/, src/db/

// how it works

Three commands. Full control.

Init your project

$ llm-context-router init --tool claude

Creates .context-router/ with memory files, agent templates, and CLAUDE.md wired up.

Route your task

$ llm-context-router ask "fix login form" \
--file src/frontend/login.js

Prints a scoped prompt. Paste it into your AI tool.

Validate + retry

$ llm-context-router run --continue

# Validates the diff. Retries with constraints if it fails.

PASS → apply. FAIL → patched prompt generated.

Validates the diff. Retries with constraints if it fails.

// honest scope

What it does not do

—Does not call any LLM
—Does not execute your code
—Does not require a network connection
—Does not replace your AI tool — it makes it smarter

// project memory

Your project gets a memory

.context-router/

.context-router/
├── CORE.md                     ← global invariants
├── CORE_LITE.md                ← quick task version
├── project_map.json            ← agent ownership map
└── memory/
    ├── MEMORY.md               ← status + recent fixes
    ├── MEMORY_MAP.md           ← file ownership
    ├── MEMORY_CHANGELOG.md     ← full history
    ├── MEMORY_INTELLIGENCE.md  ← domain knowledge
    └── MEMORY_REFERENCE.md     ← lessons learned

// supported tools

Works with your stack

Claude Code

Cursor

GitHub Copilot

Codex

Windsurf

Aider

One init command generates the right config for your tool.

$ llm-context-router init --tool cursor

// get started

Install and go