Repository navigation
Home
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.
Read these in order the first time. Each page builds on the one before.
- Getting Started: install ctxray, look at what your agents load, and write your first test.
- Concepts: the Loadout, how a piece activates, the harness, tokens and ≈, and the model backends.
- The Loadout Stack: the seven layers ctxray checks, from a file lint that costs nothing to a real model.
- Writing Tests: the test API, from one rule to a hundred prompts.
- CI Integration: GitHub Actions, GitLab, and the summary on the merge request.
- Capture Modes: the three ways ctxray learns what a harness loads, and what each one can see.
-
Configuration: every key of
ctxray.config.ts. - Harnesses: which files each harness reads, and how ctxray launches it.
- Commands: every command and option.
- Reporters and Reports: the terminal view, HTML, JUnit, Allure, JSON, and Markdown.
-
Claude Code Plugin:
/ctxray,/ctxray-test, and the MCP server. - Localization: English and Russian, and how ctxray picks one.
- 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.
- Architecture: how the code is laid out and why.
- Contributing: building, testing, and sending a change.
Start
Use
Teams
Develop
По-русски
- Начало работы · Понятия · Loadout Stack · Режимы захвата
- Тесты · Конфигурация · Политики · Харнессы · Команды · Отчёты · Плагин Claude Code
- CI · Enterprise
- Архитектура · Локализация · Участие