ctxjev-cli 0.1.2 → 0.1.4
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 +12 -9
- package/package.json +21 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# ctxjev-cli
|
|
4
4
|
|
|
5
|
-
**See what Jev would keep, drop, or summarize
|
|
5
|
+
**See what Jev would keep, drop, or summarize, right from your terminal.**
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/ctxjev-cli)
|
|
8
8
|
[](LICENSE)
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
npm install -g ctxjev-cli
|
|
21
|
-
export TYPESAFE_API_KEY=... # console.typesafe.ai/settings/keys
|
|
21
|
+
export TYPESAFE_API_KEY=... # console.typesafe.ai/settings/keys (no waitlist)
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
## Usage
|
|
@@ -41,8 +41,9 @@ ctxjev analyze transcript.jsonl --goal "Fix the checkout double-charge bug."
|
|
|
41
41
|
Jev cost: 859 input tokens, 123 output tokens (free) — ~$0.000036
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
|
|
45
|
-
between runs
|
|
44
|
+
This is real output against a sample transcript. Jev is probabilistic, so exact numbers vary
|
|
45
|
+
slightly between runs, and the cost line is computed from what Jev's API actually reported, not
|
|
46
|
+
estimated.
|
|
46
47
|
|
|
47
48
|
## Options
|
|
48
49
|
|
|
@@ -51,19 +52,19 @@ between runs. The cost line is computed from what Jev's API actually reported, n
|
|
|
51
52
|
| `--goal <text>` | Overrides the transcript's own goal (or the inferred one), if any. |
|
|
52
53
|
| `--drop-below <0-1>` | Relevance floor below which an entry is dropped (default `0.25`). |
|
|
53
54
|
| `--summarize-below <0-1>` | Relevance floor below which an entry is summarized (default `0.6`). |
|
|
54
|
-
| `--json` |
|
|
55
|
+
| `--json` | Prints machine-readable JSON (`{ decisions, savings, usage }`) instead of the report. |
|
|
55
56
|
| `--help` / `--version` | Work without `TYPESAFE_API_KEY` set. |
|
|
56
57
|
|
|
57
58
|
## Transcript formats
|
|
58
59
|
|
|
59
60
|
Auto-detected, no flag needed:
|
|
60
61
|
|
|
61
|
-
- **ctxjev's own**
|
|
62
|
-
- **Claude Code**
|
|
62
|
+
- **ctxjev's own format** is a single JSON document: `{ "goal": "...", "entries": [{ "id", "role", "toolName"?, "content", "timestamp" }] }`.
|
|
63
|
+
- **A Claude Code session** is a real `.jsonl` transcript (`transcript_path`, or anything under
|
|
63
64
|
`~/.claude/projects`). The goal is inferred from your most recent chat message unless `--goal`
|
|
64
65
|
overrides it.
|
|
65
66
|
|
|
66
|
-
> Never point this at a real, sensitive session log without checking its contents first
|
|
67
|
+
> Never point this at a real, sensitive session log without checking its contents first. Entry
|
|
67
68
|
> content is sent to the live Jev API for scoring.
|
|
68
69
|
|
|
69
70
|
## Related packages
|
|
@@ -78,4 +79,6 @@ Full docs, design notes, and example transcripts live in the main repo:
|
|
|
78
79
|
|
|
79
80
|
## License
|
|
80
81
|
|
|
81
|
-
[MIT](LICENSE)
|
|
82
|
+
[MIT](LICENSE): free to use, modify, and distribute, including in a commercial product, as long
|
|
83
|
+
as the license text and copyright notice ship with it. See the [main repo](https://github.com/x96x64/ctxjev#license)
|
|
84
|
+
for how this matches every dependency `ctxjev` currently uses.
|
package/package.json
CHANGED
|
@@ -1,14 +1,33 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ctxjev-cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "CLI for ctxjev — analyze an agent transcript and report what Jev would keep, drop, or summarize.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"cli",
|
|
7
|
+
"ai-agent",
|
|
8
|
+
"llm",
|
|
9
|
+
"context-pruning",
|
|
10
|
+
"transcript-analysis",
|
|
11
|
+
"jev",
|
|
12
|
+
"claude-code"
|
|
13
|
+
],
|
|
5
14
|
"license": "MIT",
|
|
15
|
+
"author": {
|
|
16
|
+
"name": "x96x64",
|
|
17
|
+
"url": "https://github.com/x96x64"
|
|
18
|
+
},
|
|
6
19
|
"repository": {
|
|
7
20
|
"type": "git",
|
|
8
21
|
"url": "git+https://github.com/x96x64/ctxjev.git",
|
|
9
22
|
"directory": "packages/cli"
|
|
10
23
|
},
|
|
11
24
|
"homepage": "https://github.com/x96x64/ctxjev/tree/main/packages/cli#readme",
|
|
25
|
+
"bugs": {
|
|
26
|
+
"url": "https://github.com/x96x64/ctxjev/issues"
|
|
27
|
+
},
|
|
28
|
+
"engines": {
|
|
29
|
+
"node": ">=20"
|
|
30
|
+
},
|
|
12
31
|
"type": "module",
|
|
13
32
|
"main": "./dist/index.js",
|
|
14
33
|
"bin": {
|
|
@@ -19,7 +38,7 @@
|
|
|
19
38
|
],
|
|
20
39
|
"dependencies": {
|
|
21
40
|
"picocolors": "^1.1.1",
|
|
22
|
-
"ctxjev-core": "0.1.
|
|
41
|
+
"ctxjev-core": "0.1.4"
|
|
23
42
|
},
|
|
24
43
|
"devDependencies": {
|
|
25
44
|
"@types/node": "^22",
|