Skip to content
Back to search

generator

SkillWorks with Claude CodeGitHub

CTX: a tool that solves the context management gap when working with LLMs like ChatGPT or Claude. It helps developers organize and automatically collect information from their codebase into structured documents that can be easily shared with AI assistants.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/context-hub--generator/badge.svg)](/listings/context-hub--generator)

HTML

<a href="/listings/context-hub--generator"><img src="/api/listings/context-hub--generator/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Install

**Linux / WSL:**

curl -sSL https://raw.githubusercontent.com/context-hub/generator/main/download-latest.sh | sh

**Windows:**

powershell -c "& ([ScriptBlock]::Create((irm 'https://raw.githubusercontent.com/context-hub/generator/main/download-latest.ps1'))) -AddToPath"

Connect to Claude Desktop (or Any MCP Client)

The fastest way — auto-detect OS and configure your MCP client:

ctx mcp:config

Or add manually to your MCP client config:

{
  "mcpServers": {
    "ctx": {
      "command": "ctx",
      "args": [
        "server"
      ]
    }
  }
}

For a specific project:

{
  "mcpServers": {
    "ctx": {
      "command": "ctx",
      "args": [
        "server",
        "-c",
        "/path/to/project"
      ]
    }
  }
}

That's it. Your AI assistant now has full access to your project through MCP.

Optional: Generate Context Documents

If you also want to generate static context files for copy-paste workflows:

cd your-project
ctx init       # Create context.yaml
ctx generate   # Build markdown contexts

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 265 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # CTX: Your AI Coding Companion
  2. > MCP-powered development toolkit that gives AI full access to your codebase
  3. <p>
  4. <a href="https://docs.ctxllm.com"><img alt="Docs" src="https://img.shields.io/badge/docs-green?style=for-the-badge"></a>
  5. <a href="https://raw.githubusercontent.com/context-hub/generator/refs/heads/main/json-schema.json"><img alt="Json schema" src="https://img.shields.io/badge/json_schema-blue?style=for-the-badge"></a>
  6. <a href="https://discord.gg/YmFckwVkQM"><img src="https://img.shields.io/badge/discord-chat-magenta.svg?style=for-the-badge"></a>
  7. <a href="https://github.com/context-hub/generator/releases/latest"><img src="https://img.shields.io/github/downloads/context-hub/generator/total?style=for-the-badge"></a>
  8. <a href="https://t.me/spiralphp/2504"><img alt="Telegram" src="https://img.shields.io/badge/telegram-blue.svg?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDI0YzYuNjI3IDAgMTItNS4zNzMgMTItMTJTMTguNjI3IDAgMTIgMCAwIDUuMzczIDAgMTJzNS4zNzMgMTIgMTIgMTJaIiBmaWxsPSJ1cmwoI2EpIi8+PHBhdGggZmlsbC1ydWxlPSJldmVub2RkIiBjbGlwLXJ1bGU9ImV2ZW5vZGQiIGQ9Ik01LjQyNSAxMS44NzFhNzk2LjQxNCA3OTYuNDE0IDAgMCAxIDYuOTk0LTMuMDE4YzMuMzI4LTEuMzg4IDQuMDI3LTEuNjI4IDQuNDc3LTEuNjM4LjEgMCAuMzIuMDIuNDcuMTQuMTIuMS4xNS4yMy4xNy4zMy4wMi4xLjA0LjMxLjAyLjQ3LS4xOCAxLjg5OC0uOTYgNi41MDQtMS4zNiA4LjYyMi0uMTcuOS0uNSAxLjE5OS0uODE5IDEuMjI5LS43LjA2LTEuMjI5LS40Ni0xLjg5OC0uOS0xLjA2LS42ODktMS42NDktMS4xMTktMi42NzgtMS43OTgtMS4xOS0uNzgtLjQyLTEuMjA5LjI2LTEuOTA4LjE4LS4xOCAzLjI0Ny0yLjk3OCAzLjMwNy0zLjIyOC4wMS0uMDMuMDEtLjE1LS4wNi0uMjEtLjA3LS4wNi0uMTctLjA0LS4yNS0uMDItLjExLjAyLTEuNzg4IDEuMTQtNS4wNTYgMy4zNDgtLjQ4LjMzLS45MDkuNDktMS4yOTkuNDgtLjQzLS4wMS0xLjI0OC0uMjQtMS44NjgtLjQ0LS43NS0uMjQtMS4zNDktLjM3LTEuMjk5LS43OS4wMy0uMjIuMzMtLjQ0Ljg5LS42NjlaIiBmaWxsPSIjZmZmIi8+PGRlZnM+PGxpbmVhckdyYWRpZW50IGlkPSJhIiB4MT0iMTEuOTkiIHkxPSIwIiB4Mj0iMTEuOTkiIHkyPSIyMy44MSIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPjxzdG9wIHN0b3AtY29sb3I9IiMyQUFCRUUiLz48c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiMyMjlFRDkiLz48L2xpbmVhckdyYWRpZW50PjwvZGVmcz48L3N2Zz4K"></a>
  9. <a href="https://github.com/context-hub/generator/actions/workflows/testing.yml"><img src="https://img.shields.io/github/actions/workflow/status/context-hub/generator/testing.yml?style=for-the-badge&label=Tests"></a>
  10. <a href="https://zread.ai/context-hub/generator" target="_blank"><img src="https://img.shields.io/badge/Ask_Zread-_.svg?style=for-the-badge&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" alt="zread"/></a>
  11. </p>
  12. ![Good morning, LLM](https://github.com/user-attachments/assets/8129f227-dc3f-4671-bc0e-0ecd2f3a1888)
  13. ## What is CTX?
  14. **CTX** is a single ~20 MB binary with zero dependencies. No Node.js, no Python, no runtime — just download, connect
  15. to your MCP client, and start coding with AI.
  16. Connect it to [Claude Desktop](https://claude.ai/download), [Cursor](https://cursor.com),
  17. [Cline](https://github.com/cline/cline), or any MCP-compatible client — and your AI gets direct access to read, write,
  18. search, and modify files across your projects.
  19. CTX is designed with **Claude Desktop** in mind and works best with it. Claude's deep understanding of code combined
  20. with CTX's filesystem tools, custom commands, and multi-project support creates a seamless development experience —
  21. like having a senior developer who knows your entire codebase sitting right next to you.
  22. ## Table of Contents
  23. - [Key Features](#key-features)
  24. - [Quick Start](#quick-start)
  25. - [How It Works](#how-it-works)
  26. - [Use Cases](#use-cases)
  27. - [Full Documentation](https://docs.ctxllm.com)
  28. - [License](#license)
  29. ## Key Features
  30. ### 🛠 MCP Server — AI Develops Directly in Your Project
  31. CTX provides a built-in MCP server with powerful filesystem tools:
  32. - **Read & write files** — AI creates, modifies, and analyzes code directly
  33. - **Search across codebase** — text and regex search with context lines
  34. - **PHP structure analysis** — class hierarchy, interfaces, and dependencies at a glance
  35. - **Directory exploration** — smart filtering by patterns, dates, sizes, and content
  36. ### ⚡ Custom Tools — Turn Any Command into an AI Tool
  37. Define project-specific commands that AI can execute through MCP:
  38. ```yaml
  39. tools:
  40. - id: run-tests
  41. description: "Run project tests with coverage"
  42. type: run
  43. commands:
  44. - cmd: vendor/bin/phpunit
  45. args: [ "--coverage-html", "logs/coverage" ]
  46. - id: deploy
  47. description: "Deploy to staging"
  48. type: run
  49. schema:
  50. type: object
  51. properties:
  52. branch:
  53. type: string
  54. default: "main"
  55. commands:
  56. - cmd: ./deploy.sh
  57. args: [ "{{branch}}" ]
  58. ```
  59. Tests, migrations, linters, deployments — anything your terminal can run, AI can trigger.
  60. ### 📁 Multi-Project Development
  61. Work across multiple microservices simultaneously. AI sees all your projects and can develop cross-cutting features:
  62. ```yaml
  63. projects:
  64. - name: backend-api
  65. path: ../backend
  66. description: "REST API service"
  67. - name: auth-service
  68. path: ../auth
  69. description: "Authentication microservice"
  70. - name: shared-lib
  71. path: ../packages/shared
  72. description: "Shared domain models"
  73. ```
  74. Start a session, ask AI to list available projects, and develop features that span multiple services — all in one
  75. conversation.
  76. ### 🎯 Smart Context Generation
  77. Define exactly what context your AI needs. CTX collects code from files, git diffs, GitHub repos, URLs, and more — then
  78. structures it into clean markdown documents:
  79. ```yaml
  80. documents:
  81. - description: User Authentication System
  82. outputPath: auth.md
  83. sources:
  84. - type: file
  85. sourcePaths: [ src/Auth ]
  86. filePattern: "*.php"
  87. - type: git_diff
  88. commit: "last-week"
  89. ```
  90. ### 📐 Declarative Config with JSON Schema
  91. Everything is configured through `context.yaml` with full JSON Schema support. Your AI assistant can generate and modify
  92. these configs for you — just describe what you need.
  93. ```bash
  94. ctx init # Generate initial config
  95. ctx generate # Build context documents
  96. ctx server # Start MCP server
  97. ```
  98. ## Quick Start
  99. ### Install
  100. **Linux / WSL:**
  101. ```bash
  102. curl -sSL https://raw.githubusercontent.com/context-hub/generator/main/download-latest.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 136 on GitHub
  103. ```
  104. **Windows:**
  105. ```bash
  106. powershell -c "& ([ScriptBlock]::Create((irm 'https://raw.githubusercontent.com/context-hub/generator/main/download-latest.ps1'))) -AddToPath"
  107. ```
  108. ### Connect to Claude Desktop (or Any MCP Client)
  109. The fastest way — auto-detect OS and configure your MCP client:
  110. ```bash
  111. ctx mcp:config
  112. ```
  113. Or add manually to your MCP client config:
  114. ```json
  115. {
  116. "mcpServers": {
  117. "ctx": {
  118. "command": "ctx",
  119. "args": [
  120. "server"
  121. ]
  122. }
  123. }
  124. }
  125. ```
  126. For a specific project:
  127. ```json
  128. {
  129. "mcpServers": {
  130. "ctx": {
  131. "command": "ctx",
  132. "args": [
  133. "server",
  134. "-c",
  135. "/path/to/project"
  136. ]
  137. }
  138. }
  139. }
  140. ```
  141. That's it. Your AI assistant now has full access to your project through MCP.
  142. ### Optional: Generate Context Documents
  143. If you also want to generate static context files for copy-paste workflows:
  144. ```bash
  145. cd your-project
  146. ctx init # Create context.yaml
  147. ctx generate # Build markdown contexts
  148. ```
  149. ## How It Works
  150. CTX operates in two modes that complement each other:
  151. **MCP Server Mode** — AI interacts with your codebase in real-time:
  152. ```
  153. AI Assistant ←→ CTX MCP Server ←→ Your Project Files
  154. ↕
  155. Custom Tools (tests, deploy, lint...)
  156. Multiple Projects
  157. Context Documents
  158. ```
  159. **Context Generation Mode** — build structured documents for any LLM:
  160. ```
  161. context.yaml → Sources → Filters → Modifiers → Markdown Documents
  162. ```
  163. ## Use Cases
  164. ### 🔧 AI-Powered Development (MCP)
  165. Connect CTX to Claude Desktop or Cursor. Ask your AI to explore the codebase, understand architecture, write new
  166. features, run tests, and fix issues — all without leaving the conversation.
  167. ### 🏗 Multi-Service Feature Development
  168. Working on a feature that touches multiple microservices? Register all projects, and AI can read code from one service,
  169. understand shared models, and implement changes across the entire stack.
  170. ### 📝 Context for Code Review
  171. Generate context documents with recent git diffs, relevant source files, and architecture overview. Share with reviewers
  172. or AI assistants for thorough, informed reviews.
  173. ### 🚀 Onboarding
  174. New team member? Generate a comprehensive project overview — architecture, key interfaces, domain models — in seconds.
  175. AI can then answer questions about the codebase with full context.
  176. ### 📚 Documentation Generation
  177. Point CTX at your source code with modifiers like `php-signature` to extract API surfaces, then let AI generate
  178. comprehensive documentation.
  179. ## Full Documentation
  180. For complete documentation, including all features and configuration options:
  181. https://docs.ctxllm.com
  182. ## Join Our Community
  183. [![Join Discord](https://img.shields.io/discord/1419284404315881633?color=5865F2&label=Join%20Discord&logo=discord&logoColor=white&style=for-the-badge)](https://discord.gg/YmFckwVkQM)
  184. **What you'll find:**
  185. - 💡 Share and discover configurations and workflows
  186. - 🛠️ Get help with setup and advanced usage
  187. - 🚀 Showcase your AI development workflows
  188. - 📢 First to know about new releases
  189. ---
  190. ### License
  191. This project is licensed under the MIT License.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.