Skip to content
Pavel Erokhin edited this page Nov 20, 2026 · 3 revisions

Русская версия

ctxray is an X-ray for agent harnesses: it shows what Claude Code, Codex, Cursor CLI, Gemini CLI, and OpenCode load into the model's context. Every rule, skill, MCP server and tool, command, and the system prompt comes with its tokens and the reason it got there. Then *.ctxray.ts tests check that setup on every merge request, so a broken rule never reaches your team.

Your path through the wiki

Read these in order the first time. Each page builds on the one before.

  1. Getting Started: install ctxray, look at what your agents load, and write your first test.
  2. Concepts: the Loadout, how a piece activates, the harness, tokens and ≈, and the model backends.
  3. The Loadout Stack: the seven layers ctxray checks, from a file lint that costs nothing to a real model.
  4. Writing Tests: the test API, from one rule to a hundred prompts.
  5. CI Integration: GitHub Actions, GitLab, and the summary on the merge request.

Reference

For teams

  • Policies: your organisation's token limits, banned MCP servers, and required files.
  • Enterprise: LLM gateways, proxies, your own CA certificates, internal registries, and closed networks.

For contributors

Clone this wiki locally