@builderx-ai/context-manager
v0.1.1
Published
A CLI tool for managing and injecting AI coding contexts across projects.
Maintainers
Readme
Context Injector
A CLI tool for managing and injecting AI coding contexts across projects.
Overview
Context Injector is a decentralized tool that enables teams to share and manage coding standards, best practices, and project context for AI coding assistants (Claude Code, GitHub Copilot, Cursor, etc.) through Git repositories.
Key Features
- 📦 Git-based Context Management - Distribute contexts using standard Git repositories
- 🔄 Dependency Resolution - Automatically handle context dependencies and versions
- 🤖 Multi-tool Support - Generate configurations for Claude, Copilot, Cursor, and more
- 🔒 Version Locking - Ensure team members use consistent context versions
- 🛡️ Security - Built-in integrity checks and content scanning
- 📝 Agent Collaboration - AI assistants can improve contexts and contribute back
Quick Start
# Install
npm install -g @builderx-ai/context-manager
# Initialize in your project
ctx init
# Add contexts
ctx add github.com/your-org/coding-standards
# Install all dependencies
ctx install
# Health check
ctx doctorDocumentation
- Product Design - Complete product specification
- Implementation Design - Technical design and decisions
- User Stories - Usage examples and scenarios
- 中文文档 - Chinese documentation
How It Works
1. Define Contexts in Git Repos
Create a context repository with standardized structure:
my-context/
├── context.yaml # Metadata & dependencies
├── index.md # Summary (always loaded)
├── details/ # Detailed contexts (loaded on demand)
│ ├── code-style.md
│ ├── architecture.md
│ └── testing.md
└── tools/ # Tool-specific overrides (optional)
├── claude.md
└── copilot.md2. Add to Your Project
ctx add github.com/company/engineering-standards
ctx add github.com/company/frontend-standards
ctx install3. Auto-generated Configurations
The tool automatically generates configuration files for all supported AI assistants:
CLAUDE.md- Claude Code.github/copilot-instructions.md- GitHub Copilotkilo.md- Kilo Codeopencode.md- OpenCodeAGENTS.md- OpenAI Codex
Example Use Cases
Company-wide Standards
Share coding standards across all projects:
# Add company base standards
ctx add github.com/company/engineering-standards
# Add framework-specific standards
ctx add github.com/company/react-patterns
ctx add github.com/company/typescript-guideTeam Best Practices
Capture and share team knowledge:
# Add team-specific patterns
ctx add github.com/team/backend-patterns
ctx add github.com/team/database-migrationsOpen Source Conventions
Use community best practices:
# Add open source guidelines
ctx add github.com/awesome-contexts/python-best-practices
ctx add github.com/awesome-contexts/security-patternsCreate Your Own Context
Share your standards with your team or the community:
# Create a new context repository
mkdir my-standards && cd my-standards
ctx init --context
# Follow the prompts to create:
# - Personal context for individual use
# - Organizational context for company-wide standards
# Publish to GitHub and share
gh repo create my-org/my-standards --public
git push -u origin main
git tag v1.0.0 && git push --tags
# Now others can use it
ctx add github.com/my-org/my-standardsProject Status
🚧 In Development - This project is currently in the design phase.
Contributing
Contributions are welcome! Please see our contributing guidelines for details.
Development Setup
# Clone the repository
git clone https://github.com/your-org/context-manager.git
cd context-manager
# Install dependencies
npm install
# Run tests
npm testLicense
MIT
Acknowledgments
This tool is designed to work seamlessly with:
- Claude Code by Anthropic
- GitHub Copilot by GitHub
- Cursor by Cursor
- Kilo Code by Kilo
- And other AI coding assistants
Note: English is the primary language for this project's documentation. For Chinese speakers, see README.cn.md.
