Prepare an optimal, task-specific context bundle from a repository for Claude Code and OpenAI Codex.
npm install -g context-packGlobal install:
npm install -g context-pack
context-pack bundle --task "Add Reddit OAuth + ingest pipeline" --budget 14000npx:
npx -y context-pack bundle --task "Add Reddit OAuth + ingest pipeline" --budget 14000Generates .context-pack/ in the repo:
bundle.md→ copy/paste friendly context for LLMsbundle.json→ structured representationexplain.md→ why each file was included
LLMs perform poorly when given too many files, irrelevant files, missing entrypoints, or noisy diffs.
context-pack deterministically selects, ranks, and packages the most relevant files within a strict token budget.
Heuristics (v1):
- Git relevance: recently changed, co-changed files
- Semantic relevance: filename/path/symbol matches to task text
- Dependency proximity: import relationships
- Structural importance: entrypoints, config, manifests
- Noise elimination: .gitignore, build outputs, node_modules, tests excluded by default
Token budgeting:
- Estimate tokens per file
- Stop when budget is reached
- Degrade gracefully: full → trimmed → signature-only
context-pack bundle --task "<task>" [--budget N]context-pack scan --task "<task>"context-pack explain
context-pack bundle --task "Add Reddit OAuth + ingest pipeline" --budget 1000
context-pack scan --task "Refactor config loader" --limit 25
context-pack explainSee docs/examples/ for sample outputs.
- Ensure you ran
npm run buildbefore invoking the CLI fromdist/. - If the bundle is empty, try increasing
--budgetor refining the task description.
See RELEASE.md for the full checklist.
- Codex workflows:
docs/codex.md - Claude Code plugin wrapper:
docs/claude-plugin.md - Release checklist:
RELEASE.md
- MCP server:
integrations/mcp/README.md - Claude Code:
integrations/claude-code/README.md - Codex workflows:
integrations/codex/README.md