@mairwunnx/ctxray 0.1.1-next.18 → 0.1.1-next.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +57 -23
  2. package/package.json +9 -9
package/README.md CHANGED
@@ -42,20 +42,6 @@
42
42
  - 📊 **Reports for people and for CI.** A live view in the terminal, an HTML report, JUnit, Allure, JSON, and a short Markdown summary for the merge request.
43
43
  - 🌍 **English and Russian.** ctxray picks your system's language, or the one you pass with `--lang`.
44
44
 
45
- ## Supported agents
46
-
47
- ctxray reads each agent's files without launching it. Where the agent allows it, ctxray can also launch the agent and record its requests to the model, or record a session you run yourself.
48
-
49
- | Agent | Reads files | Launches and records | Records your session |
50
- |---|:-:|:-:|:-:|
51
- | Claude Code | ✓ | ✓ | ✓ |
52
- | Codex | ✓ | ✓ | |
53
- | Gemini CLI | ✓ | ✓ | |
54
- | OpenCode | ✓ | ✓ | |
55
- | Cursor CLI | ✓ | experimental | ✓ |
56
- | Cursor (editor) | ✓ | | ✓ |
57
- | Claude Code Desktop | ✓ | | ✓ |
58
-
59
45
  ## The Loadout Stack
60
46
 
61
47
  ctxray checks your agent setup in seven layers, from cheap to expensive. The first three only read files and run on every commit in milliseconds. L4 and L5 launch the agent against a mock model, so they cost nothing either. Only L6 and L7 ask a real model, or replay its answers you recorded once.
@@ -67,18 +53,66 @@ ctxray checks your agent setup in seven layers, from cheap to expensive. The fir
67
53
 
68
54
  The [Loadout Stack](https://github.com/MairwunNx/ctxray/wiki/The-Loadout-Stack) page explains each layer with examples.
69
55
 
56
+ ## Supported agents
57
+
58
+ ctxray reads each agent's files without launching it. Where the agent allows it, ctxray also launches the agent and records its requests to the model, or records a session you run yourself. Here's which layer works for which agent:
59
+
60
+ <picture>
61
+ <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/MairwunNx/ctxray/master/docs/images/harness-support-dark.svg">
62
+ <img alt="L1 to L3 work for every harness. L4 to L7 launch the harness, so they work for Claude Code, Codex, Gemini CLI, and OpenCode, and for Cursor CLI as an experiment. The editors read the same files as their CLIs. spectate watches your own sessions in Claude Code and Cursor." src="https://raw.githubusercontent.com/MairwunNx/ctxray/master/docs/images/harness-support-light.svg">
63
+ </picture>
64
+
70
65
  ## Install
71
66
 
72
- ctxray is one executable with no runtime to install. Pick the channel you already use:
67
+ ctxray is one executable with nothing else to install. Copy the line for your system.
68
+
69
+ macOS and Linux:
70
+
71
+ ```sh
72
+ curl -fsSL https://github.com/MairwunNx/ctxray/releases/latest/download/install.sh | sh
73
+ ```
74
+
75
+ Windows, in PowerShell:
76
+
77
+ ```powershell
78
+ irm https://github.com/MairwunNx/ctxray/releases/latest/download/install.ps1 | iex
79
+ ```
80
+
81
+ Or try it in your project without installing anything:
82
+
83
+ ```sh
84
+ npx @mairwunnx/ctxray inspect
85
+ ```
86
+
87
+ <details>
88
+ <summary>npm, Homebrew, Scoop, Docker</summary>
89
+
90
+ Pin it in a project, so the team and CI run the same version:
91
+
92
+ ```sh
93
+ npm install --save-dev @mairwunnx/ctxray
94
+ ```
95
+
96
+ Homebrew:
97
+
98
+ ```sh
99
+ brew install mairwunnx/tap/ctxray
100
+ ```
101
+
102
+ Scoop:
103
+
104
+ ```powershell
105
+ scoop bucket add mairwunnx https://github.com/MairwunNx/scoop-bucket
106
+ scoop install mairwunnx/ctxray
107
+ ```
108
+
109
+ Docker, in the project folder:
110
+
111
+ ```sh
112
+ docker run --rm -v "$PWD:/work" ghcr.io/mairwunnx/ctxray inspect
113
+ ```
73
114
 
74
- | Where | Command |
75
- |---|---|
76
- | npm | `npm install -g @mairwunnx/ctxray`, or run it once with `npx @mairwunnx/ctxray` or `bunx @mairwunnx/ctxray` |
77
- | Homebrew | `brew install mairwunnx/tap/ctxray` |
78
- | Scoop | `scoop bucket add mairwunnx https://github.com/MairwunNx/scoop-bucket` and then `scoop install mairwunnx/ctxray` |
79
- | macOS and Linux | `curl -fsSL https://github.com/MairwunNx/ctxray/releases/latest/download/install.sh \| sh` |
80
- | Windows | `irm https://github.com/MairwunNx/ctxray/releases/latest/download/install.ps1 \| iex` |
81
- | Docker | `docker run --rm -v "$PWD:/work" ghcr.io/mairwunnx/ctxray inspect` |
115
+ </details>
82
116
 
83
117
  [Getting Started](https://github.com/MairwunNx/ctxray/wiki/Getting-Started) covers mirrors, Alpine, and offline machines.
84
118
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mairwunnx/ctxray",
3
- "version": "0.1.1-next.18",
3
+ "version": "0.1.1-next.20",
4
4
  "description": "X-ray for agent harnesses. See exactly what your Claude Code, Codex, Cursor & co. loaded – and test it in CI.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -31,13 +31,13 @@
31
31
  "#shared/*": "./types/shared/*"
32
32
  },
33
33
  "optionalDependencies": {
34
- "@mairwunnx/ctxray-linux-x64": "0.1.1-next.18",
35
- "@mairwunnx/ctxray-linux-arm64": "0.1.1-next.18",
36
- "@mairwunnx/ctxray-linux-x64-musl": "0.1.1-next.18",
37
- "@mairwunnx/ctxray-linux-arm64-musl": "0.1.1-next.18",
38
- "@mairwunnx/ctxray-darwin-arm64": "0.1.1-next.18",
39
- "@mairwunnx/ctxray-darwin-x64": "0.1.1-next.18",
40
- "@mairwunnx/ctxray-windows-x64": "0.1.1-next.18",
41
- "@mairwunnx/ctxray-windows-arm64": "0.1.1-next.18"
34
+ "@mairwunnx/ctxray-linux-x64": "0.1.1-next.20",
35
+ "@mairwunnx/ctxray-linux-arm64": "0.1.1-next.20",
36
+ "@mairwunnx/ctxray-linux-x64-musl": "0.1.1-next.20",
37
+ "@mairwunnx/ctxray-linux-arm64-musl": "0.1.1-next.20",
38
+ "@mairwunnx/ctxray-darwin-arm64": "0.1.1-next.20",
39
+ "@mairwunnx/ctxray-darwin-x64": "0.1.1-next.20",
40
+ "@mairwunnx/ctxray-windows-x64": "0.1.1-next.20",
41
+ "@mairwunnx/ctxray-windows-arm64": "0.1.1-next.20"
42
42
  }
43
43
  }