cotx-engine

cotx-engine compiles source code into a persistent semantic map under .cotx/ and exposes that map through CLI commands and an MCP server.

What It Does

• Parses multi-language repositories with Tree-sitter
• Compiles semantic layers for modules, concepts, contracts, and flows
• Persists human-readable YAML and JSON indexes under .cotx/
• Supports search, context lookup, impact analysis, map summaries, enrichment writes, snapshots, diffs, and incremental refresh
• Exposes the same capabilities to AI agents over MCP stdio

Install

npm install
npm run build

Run the CLI from the repo root:

node dist/index.js compile
node dist/index.js status
node dist/index.js serve
node dist/index.js serve --http --port 3000

After publishing:

npm install -g cotx-engine
cotx compile

Core Commands

cotx compile
cotx status
cotx query <keyword>
cotx context <node-id>
cotx impact <node-id>
cotx map --scope overview
cotx write <node-id> enriched.responsibility "Human-quality summary"
cotx snapshot --tag baseline
cotx diff --snapshot baseline
cotx update <changed-file>
cotx serve

MCP

Start the stdio MCP server:

cotx serve

Start the standalone HTTP MCP server:

cotx serve --http --host 127.0.0.1 --port 3000

HTTP endpoints:

• Streamable HTTP: http://127.0.0.1:3000/mcp
• Legacy SSE: http://127.0.0.1:3000/sse
• Legacy message POST: http://127.0.0.1:3000/messages?sessionId=...

Available tools:

• cotx_compile
• cotx_query
• cotx_context
• cotx_impact
• cotx_map
• cotx_write
• cotx_batch_write
• cotx_enrich
• cotx_lint
• cotx_diff

Verification

Project verification:

npm run verify

Real-project acceptance only:

npm run test:acceptance

Package boundary check:

npm run pack:check