@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.
- package/README.md +57 -23
- 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
|
|
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
|
-
|
|
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.
|
|
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.
|
|
35
|
-
"@mairwunnx/ctxray-linux-arm64": "0.1.1-next.
|
|
36
|
-
"@mairwunnx/ctxray-linux-x64-musl": "0.1.1-next.
|
|
37
|
-
"@mairwunnx/ctxray-linux-arm64-musl": "0.1.1-next.
|
|
38
|
-
"@mairwunnx/ctxray-darwin-arm64": "0.1.1-next.
|
|
39
|
-
"@mairwunnx/ctxray-darwin-x64": "0.1.1-next.
|
|
40
|
-
"@mairwunnx/ctxray-windows-x64": "0.1.1-next.
|
|
41
|
-
"@mairwunnx/ctxray-windows-arm64": "0.1.1-next.
|
|
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
|
}
|