PHPackages ctx/ctx - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. ctx/ctx ActiveLibrary ctx/ctx ======= A tool for generating contextual documentation from your codebase. 1.33.0(3mo ago)316622[11 issues](https://github.com/context-hub/generator/issues)[3 PRs](https://github.com/context-hub/generator/pulls)MITPHPPHP ^8.3CI passing Since Mar 8Pushed 1mo ago6 watchersCompare [ Source](https://github.com/context-hub/generator)[ Packagist](https://packagist.org/packages/ctx/ctx)[ Patreon](https://www.patreon.com/butschster)[ RSS](/packages/ctx-ctx/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (25)Versions (85)Used By (0) CTX: Your AI Coding Companion ============================= [](#ctx-your-ai-coding-companion) > MCP-powered development toolkit that gives AI full access to your codebase [![Docs](https://camo.githubusercontent.com/63f73eb3f7f1efa1fd34fb82bdb7487088cbbdf63c9889704cec5917aa56c269/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d677265656e3f7374796c653d666f722d7468652d6261646765)](https://docs.ctxllm.com) [![Json schema](https://camo.githubusercontent.com/067373af3db57f5919febfb827f9ec82cfc5b5a7882f45e28d72537784f3c3d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6a736f6e5f736368656d612d626c75653f7374796c653d666f722d7468652d6261646765)](https://raw.githubusercontent.com/context-hub/generator/refs/heads/main/json-schema.json) [![](https://camo.githubusercontent.com/f7fc57f0009898d9f7571ea288ecb1425d41cd5462f1c68a67179138abf94348/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646973636f72642d636861742d6d6167656e74612e7376673f7374796c653d666f722d7468652d6261646765)](https://discord.gg/YmFckwVkQM) [![](https://camo.githubusercontent.com/90174f994a4d36a141f6bc1480c7e423910a60925e05760fb61cb8d5cf8f247e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f636f6e746578742d6875622f67656e657261746f722f746f74616c3f7374796c653d666f722d7468652d6261646765)](https://github.com/context-hub/generator/releases/latest) [![Telegram](https://camo.githubusercontent.com/a749d244e8ad291705ddcacf40ce1ec2aa63b7a45421c35ee502e31da4389921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f74656c656772616d2d626c75652e7376673f7374796c653d666f722d7468652d6261646765266c6f676f3d646174613a696d6167652f7376672b786d6c3b6261736536342c50484e325a79423462577875637a30696148523063446f764c336433647935334d793576636d63764d6a41774d43397a646d636949485a705a58644362336739496a41674d4341794e4341794e43492b50484268644767675a4430695454457949444930597a59754e6a4933494441674d5449744e53347a4e7a4d674d5449744d544a544d5467754e6a4933494441674d5449674d434177494455754d7a637a494441674d544a7a4e53347a4e7a4d674d5449674d5449674d544a614969426d6157787350534a31636d776f493245704969382b50484268644767675a6d6c73624331796457786c50534a6c646d56756232526b4969426a62476c774c584a3162475539496d56325a5735765a47516949475139496b30314c6a51794e5341784d5334344e7a46684e7a6b324c6a51784e4341334f5459754e444530494441674d434178494459754f546b304c544d754d444534597a4d754d7a49344c5445754d7a6734494451754d4449334c5445754e6a4934494451754e4463334c5445754e6a4d344c6a45674d4341754d7a49754d4449754e4463754d5451754d5449754d5334784e5334794d7934784e79347a4d7934774d6934784c6a41304c6a4d784c6a41794c6a51334c5334784f4341784c6a67354f4330754f5459674e6934314d4451744d53347a4e6941344c6a59794d6930754d5463754f5330754e5341784c6a45354f5330754f444535494445754d6a49354c5334334c6a41324c5445754d6a49354c5334304e6930784c6a67354f4330754f5330784c6a41324c5334324f446b744d5334324e446b744d5334784d546b744d6934324e7a67744d5334334f5467744d5334784f5330754e7a67744c6a51794c5445754d6a41354c6a49324c5445754f5441344c6a45344c5334784f43417a4c6a49304e7930794c6a6b334f43417a4c6a4d774e79307a4c6a49794f4334774d5330754d444d754d4445744c6a45314c5334774e6930754d6a45744c6a41334c5334774e6930754d5463744c6a41304c5334794e5330754d4449744c6a45784c6a41794c5445754e7a6734494445754d5451744e5334774e5459674d79347a4e4467744c6a51344c6a4d7a4c5334354d446b754e446b744d5334794f546b754e4467744c6a517a4c5334774d5330784c6a49304f4330754d6a51744d5334344e6a67744c6a51304c5334334e5330754d6a51744d53347a4e446b744c6a4d334c5445754d6a6b354c5334334f5334774d7930754d6a49754d7a4d744c6a51304c6a67354c5334324e6a6c614969426d615778735053496a5a6d5a6d4969382b5047526c5a6e4d2b50477870626d5668636b6479595752705a57353049476c6b50534a68496942344d5430694d5445754f546b6949486b7850534977496942344d6a30694d5445754f546b6949486b79505349794d7934344d5349675a334a685a476c6c626e5256626d6c30637a306964584e6c636c4e7759574e6c5432355663325569506a787a6447397749484e3062334174593239736233493949694d7951554643525555694c7a343863335276634342765a6d5a7a5a585139496a456949484e3062334174593239736233493949694d794d6a6c4652446b694c7a34384c327870626d5668636b6479595752705a573530506a77765a47566d637a34384c334e325a7a344b)](https://t.me/spiralphp/2504) [![](https://camo.githubusercontent.com/47d46f6dd847d9c25bd90eab541146e9e0ffdd07cbbbdc7f9b0416688c5ce67e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f636f6e746578742d6875622f67656e657261746f722f74657374696e672e796d6c3f7374796c653d666f722d7468652d6261646765266c6162656c3d5465737473)](https://github.com/context-hub/generator/actions/workflows/testing.yml) [![zread](https://camo.githubusercontent.com/c3c09550266dcd9bf9c81a2b3150c01b2553935f6df94e2355ad1552bf0f28f8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f41736b5f5a726561642d5f2e7376673f7374796c653d666f722d7468652d626164676526636f6c6f723d303062306161266c6162656c436f6c6f723d303030303030266c6f676f3d64617461253341696d616765253246737667253242786d6c25334262617365363425324350484e325a79423361575230614430694d5459694947686c6157646f644430694d54596949485a705a58644362336739496a41674d4341784e6941784e6949675a6d6c7362443069626d39755a53496765473173626e4d39496d6830644841364c79393364336375647a4d7562334a6e4c7a49774d44417663335a6e496a344b50484268644767675a443069545451754f5459784e5459674d5334324d444178534449754d6a51784e545a444d5334344f446778494445754e6a41774d5341784c6a59774d545532494445754f4467324e6a51674d5334324d4445314e6941794c6a49304d4446574e4334354e6a4178517a45754e6a41784e5459674e53347a4d544d314e6941784c6a67344f4445674e5334324d444178494449754d6a51784e5459674e5334324d444178534451754f5459784e545a444e53347a4d5455774d6941314c6a59774d4445674e5334324d4445314e6941314c6a4d784d7a5532494455754e6a41784e5459674e4334354e6a4178566a49754d6a51774d554d314c6a59774d545532494445754f4467324e6a51674e53347a4d5455774d6941784c6a59774d4445674e4334354e6a45314e6941784c6a59774d4446614969426d615778735053496a5a6d5a6d496938253242436a78775958526f49475139496b30304c6a6b324d545532494445774c6a4d354f546c494d6934794e4445314e6b4d784c6a67344f4445674d5441754d7a6b354f5341784c6a59774d545532494445774c6a59344e6a51674d5334324d4445314e6941784d5334774d7a6b35566a457a4c6a63314f546c444d5334324d4445314e6941784e4334784d544d30494445754f4467344d5341784e43347a4f546b35494449754d6a51784e5459674d5451754d7a6b354f5567304c6a6b324d545532517a55754d7a45314d4449674d5451754d7a6b354f5341314c6a59774d545532494445304c6a45784d7a51674e5334324d4445314e6941784d7934334e546b35566a45784c6a417a4f546c444e5334324d4445314e6941784d4334324f445930494455754d7a45314d4449674d5441754d7a6b354f5341304c6a6b324d545532494445774c6a4d354f546c614969426d615778735053496a5a6d5a6d496938253242436a78775958526f49475139496b30784d7934334e546730494445754e6a41774d5567784d5334774d7a6730517a45774c6a59344e5341784c6a59774d4445674d5441754d7a6b344e4341784c6a67344e6a5930494445774c6a4d354f4451674d6934794e444178566a51754f5459774d554d784d43347a4f546730494455754d7a457a4e5459674d5441754e6a6731494455754e6a41774d5341784d5334774d7a6730494455754e6a41774d5567784d7934334e546730517a45304c6a45784d546b674e5334324d444178494445304c6a4d354f4451674e53347a4d544d314e6941784e43347a4f546730494451754f5459774d5659794c6a49304d4446444d5451754d7a6b344e4341784c6a67344e6a5930494445304c6a45784d546b674d5334324d4441784944457a4c6a63314f4451674d5334324d444178576949675a6d6c736244306949325a6d5a69497650676f38634746306143426b50534a4e4e4341784d6b77784d694130544451674d544a614969426d615778735053496a5a6d5a6d496938253242436a78775958526f49475139496b303049444579544445794944516949484e30636d39725a54306949325a6d5a694967633352796232746c4c5864705a48526f505349784c6a556949484e30636d39725a5331736157356c5932467750534a79623356755a43497650676f384c334e325a7a344b266c6f676f436f6c6f723d666666666666)](https://zread.ai/context-hub/generator) [![Good morning, LLM](https://private-user-images.githubusercontent.com/773481/429988152-8129f227-dc3f-4671-bc0e-0ecd2f3a1888.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0NTE5OTUsIm5iZiI6MTc3NTQ1MTY5NSwicGF0aCI6Ii83NzM0ODEvNDI5OTg4MTUyLTgxMjlmMjI3LWRjM2YtNDY3MS1iYzBlLTBlY2QyZjNhMTg4OC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNDA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDQwNlQwNTAxMzVaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT00MjA0N2Y2NTg1MThmMmJkNTJjYjM0Yjc3MDUzZTcyNjE5ZDhmNGJlYTc2ZDI0ZjhkMzkxMWM1OGQ3MWNkNzM2JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.SIzv4zCzFrn1p2zJsXxStC9n-ajKlKkFsxRSW6kpjCU)](https://private-user-images.githubusercontent.com/773481/429988152-8129f227-dc3f-4671-bc0e-0ecd2f3a1888.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0NTE5OTUsIm5iZiI6MTc3NTQ1MTY5NSwicGF0aCI6Ii83NzM0ODEvNDI5OTg4MTUyLTgxMjlmMjI3LWRjM2YtNDY3MS1iYzBlLTBlY2QyZjNhMTg4OC5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNDA2JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDQwNlQwNTAxMzVaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT00MjA0N2Y2NTg1MThmMmJkNTJjYjM0Yjc3MDUzZTcyNjE5ZDhmNGJlYTc2ZDI0ZjhkMzkxMWM1OGQ3MWNkNzM2JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCJ9.SIzv4zCzFrn1p2zJsXxStC9n-ajKlKkFsxRSW6kpjCU) What is CTX? ------------ [](#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](https://claude.ai/download), [Cursor](https://cursor.com), [Cline](https://github.com/cline/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 ----------------- [](#table-of-contents) - [Key Features](#key-features) - [Quick Start](#quick-start) - [How It Works](#how-it-works) - [Use Cases](#use-cases) - [Full Documentation](https://docs.ctxllm.com) - [License](#license) Key Features ------------ [](#key-features) ### 🛠 MCP Server — AI Develops Directly in Your Project [](#-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 [](#-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 [](#-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 [](#-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 [](#-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. ``` ctx init # Generate initial config ctx generate # Build context documents ctx server # Start MCP server ``` Quick Start ----------- [](#quick-start) ### Install [](#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) [](#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 [](#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 ``` How It Works ------------ [](#how-it-works) CTX operates in two modes that complement each other: **MCP Server Mode** — AI interacts with your codebase in real-time: ``` AI Assistant ←→ CTX MCP Server ←→ Your Project Files ↕ Custom Tools (tests, deploy, lint...) Multiple Projects Context Documents ``` **Context Generation Mode** — build structured documents for any LLM: ``` context.yaml → Sources → Filters → Modifiers → Markdown Documents ``` Use Cases --------- [](#use-cases) ### 🔧 AI-Powered Development (MCP) [](#-ai-powered-development-mcp) Connect CTX to Claude Desktop or Cursor. Ask your AI to explore the codebase, understand architecture, write new features, run tests, and fix issues — all without leaving the conversation. ### 🏗 Multi-Service Feature Development [](#-multi-service-feature-development) Working on a feature that touches multiple microservices? Register all projects, and AI can read code from one service, understand shared models, and implement changes across the entire stack. ### 📝 Context for Code Review [](#-context-for-code-review) Generate context documents with recent git diffs, relevant source files, and architecture overview. Share with reviewers or AI assistants for thorough, informed reviews. ### 🚀 Onboarding [](#-onboarding) New team member? Generate a comprehensive project overview — architecture, key interfaces, domain models — in seconds. AI can then answer questions about the codebase with full context. ### 📚 Documentation Generation [](#-documentation-generation) Point CTX at your source code with modifiers like `php-signature` to extract API surfaces, then let AI generate comprehensive documentation. Full Documentation ------------------ [](#full-documentation) For complete documentation, including all features and configuration options: Join Our Community ------------------ [](#join-our-community) [![Join Discord](https://camo.githubusercontent.com/d96618a31079e1d6f5dd53f9e3aee3e00049361684c0ccb0949db2c3536299f3/68747470733a2f2f696d672e736869656c64732e696f2f646973636f72642f313431393238343430343331353838313633333f636f6c6f723d353836354632266c6162656c3d4a6f696e253230446973636f7264266c6f676f3d646973636f7264266c6f676f436f6c6f723d7768697465267374796c653d666f722d7468652d6261646765)](https://discord.gg/YmFckwVkQM) **What you'll find:** - 💡 Share and discover configurations and workflows - 🛠️ Get help with setup and advanced usage - 🚀 Showcase your AI development workflows - 📢 First to know about new releases --- ### License [](#license) This project is licensed under the MIT License. ### Health Score 53 — FairBetter than 96% of packages Maintenance89 Actively maintained with recent releases Popularity24 Limited adoption so far Community23 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor1 Top contributor holds 94.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~5 days Recently: every ~12 days Total 67 Last Release 58d ago PHP version history (2 changes)1.0.0PHP ^8.2 1.20.0PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/773481?v=4)[Pavel Buchnev](/maintainers/butschster)[@butschster](https://github.com/butschster) --- Top Contributors [![butschster](https://avatars.githubusercontent.com/u/773481?v=4)](https://github.com/butschster "butschster (606 commits)")[![roxblnfk](https://avatars.githubusercontent.com/u/4152481?v=4)](https://github.com/roxblnfk "roxblnfk (11 commits)")[![savinmikhail](https://avatars.githubusercontent.com/u/99592925?v=4)](https://github.com/savinmikhail "savinmikhail (8 commits)")[![0oAstro](https://avatars.githubusercontent.com/u/79555780?v=4)](https://github.com/0oAstro "0oAstro (3 commits)")[![vjik](https://avatars.githubusercontent.com/u/525501?v=4)](https://github.com/vjik "vjik (3 commits)")[![markinigor](https://avatars.githubusercontent.com/u/18714154?v=4)](https://github.com/markinigor "markinigor (2 commits)")[![cto-new[bot]](https://avatars.githubusercontent.com/in/364074?v=4)](https://github.com/cto-new[bot] "cto-new[bot] (2 commits)")[![MihailDev](https://avatars.githubusercontent.com/u/2392194?v=4)](https://github.com/MihailDev "MihailDev (1 commits)")[![eltociear](https://avatars.githubusercontent.com/u/22633385?v=4)](https://github.com/eltociear "eltociear (1 commits)")[![a-kurago](https://avatars.githubusercontent.com/u/79331949?v=4)](https://github.com/a-kurago "a-kurago (1 commits)")[![xepozz](https://avatars.githubusercontent.com/u/6815714?v=4)](https://github.com/xepozz "xepozz (1 commits)") --- Tags contextcontext-aware-aicontext-engineeringcontext-extractorhacktoberfestinstructionsllmmcpmcp-servermcp-serversmcp-toolsphpprompt-engineeringvibe-codingphpContextphp8llmprompt ### Code Quality Static AnalysisPsalm, Rector Type Coverage Yes ### Embed Badge ![Health badge](/badges/ctx-ctx/health.svg) ``` [![Health](https://phpackages.com/badges/ctx-ctx/health.svg)](https://phpackages.com/packages/ctx-ctx) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.6k509.9M16.9k](/packages/laravel-framework)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M646](/packages/sylius-sylius)[tempest/framework The PHP framework that gets out of your way. 2.1k23.1k9](/packages/tempest-framework)[contao/core-bundle Contao Open Source CMS 1231.6M2.3k](/packages/contao-core-bundle)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)