CTX: Professional AI Development for Every Developer

Create LLM-ready contexts in minutes

Table of Contents

• Quick Start

• Full Documentation

• License

During development, your codebase constantly evolves. Files are added, modified, and removed. Each time you need to continue working with an LLM, you need to regenerate context to provide updated information about your current codebase state.

CTX is a context management tool that gives developers full control over what AI sees from their codebase. Instead of letting AI tools guess what's relevant, you define exactly what context to provide - making your AI-assisted development more predictable, secure, and efficient.

It helps developers organize contexts and automatically collect information from their codebase into structured documents that can be easily shared with LLM.

For example, a developer describes what context they need:

This configuration will gather all PHP files from the src/Auth directory and any PHP files containing "User" in their name from the src/Models directory into a single context file .context/auth.md. This file can then be pasted into a chat session or provided via the built-in MCP server.

Why CTX?

Current AI coding tools automatically scan your entire codebase, which creates several issues:

• Security risk: Your sensitive files (env vars, tokens, private code) get uploaded to cloud services

• Context dilution: AI gets overwhelmed with irrelevant code, reducing output quality

• No control: You can't influence what the AI considers when generating responses

• Expensive: Premium tools charge based on how much they scan, not how much you actually need

The CTX Approach

You know your code better than any AI. CTX puts you in control:

• ✅ Define exactly what context to share - no more, no less

• ✅ Keep sensitive data local - works with local LLMs or carefully curated cloud contexts

• ✅ Generate reusable, shareable contexts - commit configurations to your repo

• ✅ Improve code architecture - designing for AI context windows naturally leads to better modular code

• ✅ Works with any LLM - Claude, ChatGPT, local models, or future tools

Related MCP server: Claude-LMStudio Bridge

Quick Start

Download and install the tool using our installation script:

Linux / Wsl

Windows

This installs the ctx command to your system (typically in /usr/local/bin).

Want more options? See the complete Installation Guide for alternative installation methods.

5-Minute Setup

1. Initialize your project:

This generates a context.yaml file with a basic configuration and shows your project structure, helping you understand what contexts might be useful.

Check the Command Reference for all available commands and options.

2. Create your first context:

3. Use with your favorite AI:

• Copy the generated markdown files to your AI chat

• Or use the built-in MCP server with your MCP client (e.g., Claude Desktop, Cursor, Continue, Windsurf)

• Or process locally with open-source models

Real-World Use Cases

🚀 Onboarding New Team Member

📝 Feature Development

📚 Documentation Generation

Key Features

🎯 Precise Context Control

• Define exactly which files, directories, or code patterns to include

• Filter by content, file patterns, date ranges, or size

• Apply modifiers to extract only relevant parts (e.g., function signatures)

🔒 Security by Design

• Local-first: Generate contexts locally, choose what to share

• No automatic uploads: Unlike tools that scan everything, you control what gets sent

• Works with local models: Use completely offline with Ollama, LM Studio, etc.

🔄 Version Control Integration

• Context configurations are part of your project

• Team members get the same contexts

• Evolve contexts as your codebase changes

• Include git diffs to show recent changes

🛠 Developer Experience

• Fast: Generate contexts in seconds, not minutes of manual copying

• Flexible: Works with any AI tool or local model

• Shareable: Commit configurations, share with team

• Extensible: Plugin system for custom sources and modifiers

Architecture

CTX follows a simple pipeline:

• Sources: Where to get content (files, GitHub, git diffs, URLs, etc.)

• Filters: What to include/exclude (patterns, content, dates, sizes)

• Modifiers: How to transform content (extract signatures, remove comments)

• Output: Structured markdown ready for AI consumption

Connect to an MCP Client (Optional)

For a more seamless experience, you can connect CTX to any MCP-compatible client using the built-in MCP server.

This command:

• 🔍 Auto-detects your OS (Windows, Linux, macOS, WSL)

• 🧩 Lets you choose your MCP client (e.g., Claude Desktop, Cursor, Continue, Windsurf)

• 🎯 Generates and optionally installs the correct config for your environment

• 📋 Provides copy‑paste ready JSON if you prefer manual setup

• 🧭 Includes setup instructions and troubleshooting tips

Global Registry Mode (recommended for multiple projects/clients):

If you prefer manual setup, point your MCP client to the CTX server:

Note: Read more about the MCP server for detailed setup instructions and troubleshooting. Specific config file locations vary by client.

Now you can use your preferred MCP client (including Claude Desktop) to ask questions about your codebase without manually uploading context files.

Custom Tools

Define project-specific commands that can be executed through the MCP interface:

Full Documentation

For complete documentation, including all available features and configuration options, please visit:

https://docs.ctxllm.com

Join Our Community

Join hundreds of developers using CTX for professional AI-assisted coding:

What you'll find in our Discord:

• 💡 Share and discover context configurations

• 🛠️ Get help with setup and advanced usage

• 🚀 Showcase your AI development workflows

• 🤝 Connect with like-minded developers

• 📢 First to know about new releases and features

License

This project is licensed under the MIT License.