context-mixer 0.3.1

A tool to create, organize, merge and deploy reusable context instructions across multiple GenAI coding assistants

Context Mixer

A command-line tool to create, organize, merge and deploy reusable context instructions across multiple GenAI coding assistants.

Purpose

Context Mixer helps developers manage context fragments for different AI coding assistants (e.g., GitHub Copilot, Cursor/Windsor, Claude, Junie) in a structured, version-controlled way using the CRAFT framework for intelligent knowledge management.

Features

• 🔄 Mix & Slice context fragments into variant-specific bundles with CRAFT-aware filtering
• 📥 Ingest & Normalize existing context artifacts from multiple projects with project isolation
• 📚 Source-of-Truth Library under Git for history and collaboration
• 🛡️ Conflict Detection & Quarantine to prevent knowledge contamination
• ⚡ Token Optimization with intelligent selection to fit assistant limits
• 🎯 Project Context Isolation to prevent cross-project knowledge contamination

Installation

# Install with pipx (recommended)
pipx install context-mixer

# Or with pip
pip install context-mixer

# For development
git clone https://github.com/svetzal/context-mixer.git
cd context-mixer
pip install -e ".[dev]"

Requirements

• Python 3.12+
• Git
• Access to either Ollama (local) or OpenAI (remote) LLM services

Quick Start

# Initialize a new context library
cmx init

# Ingest existing contexts with project identification
cmx ingest ./my-react-project --project-id "react-frontend" --project-name "React Frontend App"
cmx ingest ./my-python-api --project-id "python-api" --project-name "Python REST API"

# Review and resolve any quarantined knowledge conflicts
cmx quarantine list
cmx quarantine resolve <chunk-id> accept "Approved after review"

# Assemble contexts for a specific target with project filtering
cmx assemble copilot --project-ids "react-frontend,python-api" --token-budget 8192

# Slice context.md into content categories with CRAFT-aware filtering
cmx slice --granularity detailed --domains technical,business --project-ids "react-frontend"

# Sync with remote repository (coming soon)
cmx sync

License

MIT