CTX: Your AI Coding Companion

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:

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:

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:

documents:
  - description: User Authentication System
    outputPath: auth.md
    sources:
      - type: file
        sourcePaths: [ src/Auth ]
        filePattern: "*.php"
      - type: git_diff
        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.