ctxjev-cli 0.1.0 → 0.1.1
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 +65 -6
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,22 +1,81 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
1
3
|
# ctxjev-cli
|
|
2
4
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
+
**See what Jev would keep, drop, or summarize — right from your terminal.**
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/ctxjev-cli)
|
|
8
|
+
[](LICENSE)
|
|
9
|
+
[](package.json)
|
|
10
|
+
|
|
11
|
+
[Install](#install) · [Usage](#usage) · [Options](#options) · [Transcript formats](#transcript-formats) · [Related packages](#related-packages)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Install
|
|
5
18
|
|
|
6
19
|
```bash
|
|
7
20
|
npm install -g ctxjev-cli
|
|
8
21
|
export TYPESAFE_API_KEY=... # console.typesafe.ai/settings/keys — no waitlist
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
## Usage
|
|
9
25
|
|
|
26
|
+
```bash
|
|
10
27
|
ctxjev analyze transcript.jsonl --goal "Fix the checkout double-charge bug."
|
|
11
28
|
```
|
|
12
29
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
30
|
+
```console
|
|
31
|
+
e1 bash summarize score 0.48 ran: npm test -- checkout.test.ts — 12 passed, 0 failed
|
|
32
|
+
e2 read summarize score 0.26 read package.json — saw the dependency list and script names
|
|
33
|
+
e3 grep keep score 0.89 grep "charge" in src/payments.ts — found chargeCustomer() c…
|
|
34
|
+
e4 bash drop score 0.14 ran: git log --oneline -5 — recent commits about unrelated …
|
|
35
|
+
e5 read keep score 0.93 read src/payments.ts — the retry handler re-calls chargeCus…
|
|
36
|
+
e6 assistant keep score 0.94 Found it: the retry path doesn't check for an in-flight or …
|
|
37
|
+
e7 bash drop score 0.14 ran: ls public/audio — unrelated, was checking something el…
|
|
38
|
+
|
|
39
|
+
3 kept, 2 summarized, 2 dropped (of 7 entries)
|
|
40
|
+
~60 / 154 tokens saved (39%)
|
|
41
|
+
Jev cost: 859 input tokens, 123 output tokens (free) — ~$0.000036
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
*(real output, against a sample transcript — Jev is probabilistic, so exact numbers vary slightly
|
|
45
|
+
between runs. The cost line is computed from what Jev's API actually reported, not estimated.)*
|
|
46
|
+
|
|
47
|
+
## Options
|
|
48
|
+
|
|
49
|
+
| Flag | What it does |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| `--goal <text>` | Overrides the transcript's own goal (or the inferred one), if any. |
|
|
52
|
+
| `--drop-below <0-1>` | Relevance floor below which an entry is dropped (default `0.25`). |
|
|
53
|
+
| `--summarize-below <0-1>` | Relevance floor below which an entry is summarized (default `0.6`). |
|
|
54
|
+
| `--json` | Print machine-readable JSON — `{ decisions, savings, usage }` — instead of the report. |
|
|
55
|
+
| `--help` / `--version` | Work without `TYPESAFE_API_KEY` set. |
|
|
56
|
+
|
|
57
|
+
## Transcript formats
|
|
58
|
+
|
|
59
|
+
Auto-detected, no flag needed:
|
|
60
|
+
|
|
61
|
+
- **ctxjev's own** — a single JSON document: `{ "goal": "...", "entries": [{ "id", "role", "toolName"?, "content", "timestamp" }] }`.
|
|
62
|
+
- **Claude Code** — a real session `.jsonl` (`transcript_path`, or anything under
|
|
63
|
+
`~/.claude/projects`). The goal is inferred from your most recent chat message unless `--goal`
|
|
64
|
+
overrides it.
|
|
65
|
+
|
|
66
|
+
> Never point this at a real, sensitive session log without checking its contents first — entry
|
|
67
|
+
> content is sent to the live Jev API for scoring.
|
|
68
|
+
|
|
69
|
+
## Related packages
|
|
70
|
+
|
|
71
|
+
| Package | What it is |
|
|
72
|
+
| --- | --- |
|
|
73
|
+
| [`ctxjev-core`](https://www.npmjs.com/package/ctxjev-core) | The engine this CLI wraps. |
|
|
74
|
+
| [`ctxjev-mcp`](https://www.npmjs.com/package/ctxjev-mcp) | The same scoring, as MCP tools for Claude Code, Codex, and other agent hosts. |
|
|
16
75
|
|
|
17
76
|
Full docs, design notes, and example transcripts live in the main repo:
|
|
18
77
|
**[github.com/x96x64/ctxjev](https://github.com/x96x64/ctxjev)**.
|
|
19
78
|
|
|
20
79
|
## License
|
|
21
80
|
|
|
22
|
-
MIT
|
|
81
|
+
[MIT](LICENSE)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ctxjev-cli",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "CLI for ctxjev — analyze an agent transcript and report what Jev would keep, drop, or summarize.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
],
|
|
20
20
|
"dependencies": {
|
|
21
21
|
"picocolors": "^1.1.1",
|
|
22
|
-
"ctxjev-core": "0.1.
|
|
22
|
+
"ctxjev-core": "0.1.1"
|
|
23
23
|
},
|
|
24
24
|
"devDependencies": {
|
|
25
25
|
"@types/node": "^22",
|