context-hub/generator

> MCP-powered development toolkit that gives AI full access to your codebase
## What is CTX?
CTX is a single ~20 MB binary with zero dependencies. No Node.js, no Python, no runtime — just download, connect
to your MCP client, and start coding with AI.
Connect it to Claude Desktop, Cursor,
Cline, or any MCP-compatible client — and your AI gets direct access to read, write,
search, and modify files across your projects.
CTX is designed with Claude Desktop in mind and works best with it. Claude's deep understanding of code combined
with CTX's filesystem tools, custom commands, and multi-project support creates a seamless development experience —
like having a senior developer who knows your entire codebase sitting right next to you.
## Table of Contents
Key Features
Quick Start
How It Works
Use Cases
Full Documentation
License
## Key Features
### 🛠 MCP Server — AI Develops Directly in Your Project
CTX provides a built-in MCP server with powerful filesystem tools:
Read & write files — AI creates, modifies, and analyzes code directly
Search across codebase — text and regex search with context lines
PHP structure analysis — class hierarchy, interfaces, and dependencies at a glance
Directory exploration — smart filtering by patterns, dates, sizes, and content
### ⚡ Custom Tools — Turn Any Command into an AI Tool
Define project-specific commands that AI can execute through MCP:
yaml
tools:
id: run-tests
description: "Run project tests with coverage"
type: run
commands:
cmd: vendor/bin/phpunit
args: [ "--coverage-html", "logs/coverage" ]
id: deploy
description: "Deploy to staging"
type: run
schema:
type: object
properties:
branch:
type: string
default: "main"
commands:
cmd: ./deploy.sh
args: [ "{{branch}}" ]
Tests, migrations, linters, deployments — anything your terminal can run, AI can trigger.
### 📁 Multi-Project Development
Work across multiple microservices simultaneously. AI sees all your projects and can develop cross-cutting features:
yaml
projects:
name: backend-api
path: ../backend
description: "REST API service"
name: auth-service
path: ../auth
description: "Authentication microservice"
name: shared-lib
path: ../packages/shared
description: "Shared domain models"
Start a session, ask AI to list available projects, and develop features that span multiple services — all in one
conversation.
### 🎯 Smart Context Generation
Define exactly what context your AI needs. CTX collects code from files, git diffs, GitHub repos, URLs, and more — then
structures it into clean markdown documents:
yaml
documents:
description: User Authentication System
outputPath: auth.md
sources:
type: file
sourcePaths: [ src/Auth ]
filePattern: ".php"
type: gitdiff
commit: "last-week"
### 📐 Declarative Config with JSON Schema
Everything is configured through context.yaml with full JSON Schema support. Your AI assistant can generate and modify
these configs for you — just describe what you need.
bash
ctx init # Generate initial config
ctx generate # Build context documents
ctx server # Start MCP server
## Quick Start
### Install
Linux / WSL:
bash
curl -sSL https://raw.githubusercontent.com/context-hub/generator/main/download-latest.sh | sh
Windows:
bash
powershell -c "& ([ScriptBlock]::Create((irm 'https://raw.githubusercontent.com/context-hub/generator/main/download-latest.ps1'))) -AddToPath"