slopie 1.8.0 → 1.8.5
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 +52 -33
- package/dist/audit-native-worker.js +274 -108
- package/dist/audit-native-worker.js.map +4 -4
- package/dist/potsherd.js +7768 -3296
- package/dist/potsherd.js.map +4 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,60 +1,79 @@
|
|
|
1
1
|
# Slopie
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Requires Node.js 22 or newer.
|
|
6
|
-
|
|
7
|
-
## Audit your recorded history
|
|
3
|
+
**A Wrapped for your coding agents.** One command reads the session history that Claude Code, Codex, Cursor and pi already keep on your disk, and tells you who you were this year.
|
|
8
4
|
|
|
9
5
|
```sh
|
|
10
6
|
npx slopie audit
|
|
11
7
|
```
|
|
12
8
|
|
|
13
|
-
|
|
9
|
+
No signup, no API key, nothing uploaded. Requires Node.js 22+.
|
|
14
10
|
|
|
15
|
-
|
|
11
|
+
|
|
16
12
|
|
|
17
|
-
|
|
13
|
+
<sub>Example poster rendered from test data. Yours is computed from your own history.</sub>
|
|
18
14
|
|
|
19
|
-
|
|
15
|
+
## What you get
|
|
20
16
|
|
|
21
|
-
|
|
17
|
+
A short story in your terminal (←/→ to move), ending on one poster you can share:
|
|
22
18
|
|
|
23
|
-
|
|
19
|
+
- **Your archetype.** One of 22, like *The 2AM Deployer*, *Jekyll & Hyde*, *Middle Management*, *The 'Keep going' Button* or *First Spared in the Uprising*, plus 5 rare legendary combos. Every tagline quotes one of your own numbers.
|
|
20
|
+
- **The bill.** What your agent work would cost at API list prices, per agent and per month, plus your priciest day and your single most expensive sentence.
|
|
21
|
+
- **Your manners.** F-bombs per thank-you, how your swearing changed over the year, the hour you're angriest and the hour you're a saint.
|
|
22
|
+
- **Your models.** Which model actually did the work (by recorded output tokens), the one you swear at most and the one you thank most.
|
|
23
|
+
- **Your habits.** Catchphrase, what you call your agent, longest sit, late nights, streaks, how many subagents you launched.
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
Press `s` to save the poster as an image with no project names on it. `--plain` prints the story as text, and `--json` prints the numbers.
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
It takes about 20 seconds the first time on a large history, then about a second.
|
|
28
28
|
|
|
29
|
-
|
|
30
|
-
pnpm install --frozen-lockfile
|
|
31
|
-
pnpm build
|
|
32
|
-
pnpm vendor
|
|
33
|
-
node packages/cli/bin/slopie.js --help
|
|
34
|
-
```
|
|
29
|
+
## Private by default
|
|
35
30
|
|
|
36
|
-
|
|
31
|
+
The audit runs entirely on your machine: it reads your session files and writes only a local cache. It makes no network requests unless you pass `--online`, which lets a free hosted model (OpenCode Zen / TypeSafe Jev) polish the story's wording. Even then it sends only aggregates and a few filtered short quotes, never your prompts, and you see a notice before each request.
|
|
37
32
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
33
|
+
## How the numbers are made
|
|
34
|
+
|
|
35
|
+
- **Supported agents:** Claude Code, Codex (including compressed `.jsonl.zst` sessions and archives), Claude Desktop agent sessions, pi, OpenCode, and Cursor/Gemini/Copilot prompts.
|
|
36
|
+
- **Each session counts once.** Copies, forks, resumes and archives of a session are deduplicated per session lineage, and divergent tails are merged. Codex sessions imported from Claude Code and `codex exec` automation runs aren't counted as chats.
|
|
37
|
+
- **Spend has three parts, never added together:**
|
|
38
|
+
- *measured*, from recorded token usage;
|
|
39
|
+
- *recovered*, from Claude Code's own usage stats on days whose logs are gone;
|
|
40
|
+
- an *estimated* range for prompts whose logs were deleted, clearly labelled.
|
|
41
|
+
|
|
42
|
+
Prices are current API list prices, including long-context tiers. They are not your subscription bill.
|
|
43
|
+
- **Unknown models stay unpriced.** A model without a published price is reported as unpriced tokens, never guessed. Model shares count only models actually recorded on responses.
|
|
44
|
+
- **Checked against independent scripts.** On a 35 GB, 4,400-prompt history, the totals match two scripts that parse the raw files directly, to within 0.5%.
|
|
43
45
|
|
|
44
|
-
|
|
46
|
+
More detail: [coverage and privacy](https://github.com/HulkInTherapy/slopie/blob/main/docs/audit-terminal.md).
|
|
45
47
|
|
|
46
|
-
##
|
|
48
|
+
## Memory for your agents
|
|
47
49
|
|
|
48
|
-
|
|
50
|
+
Slopie started as local memory for coding agents, and that's still underneath: *your agents forget, slopie remembers.* `slopie setup` connects it to Claude Code, Codex, pi or OpenCode. Your agent can then search past sessions across projects and quote them exactly. The v2 agent contract has four tools:
|
|
49
51
|
|
|
50
|
-
|
|
52
|
+
- `potsherd_recall`: scoped search;
|
|
53
|
+
- `potsherd_read`: exact source evidence;
|
|
54
|
+
- `potsherd_graft`: handoffs;
|
|
55
|
+
- `potsherd_write`: explicit memory.
|
|
51
56
|
|
|
52
|
-
|
|
57
|
+
See [MCP configuration](https://github.com/HulkInTherapy/slopie/blob/main/docs/mcp-clients.md) and the [agent contract](https://github.com/HulkInTherapy/slopie/blob/main/docs/AGENT-CONTRACT.md). The memory features are less mature than the audit; [release notes](https://github.com/HulkInTherapy/slopie/blob/main/docs/release-candidate.md) list measured results and limits.
|
|
53
58
|
|
|
54
|
-
##
|
|
59
|
+
## Install, build, upgrade
|
|
55
60
|
|
|
56
|
-
|
|
61
|
+
To install globally:
|
|
62
|
+
|
|
63
|
+
```sh
|
|
64
|
+
npm install -g slopie
|
|
65
|
+
slopie audit
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
`potsherd` remains a compatibility alias, and existing `POTSHERD_*` settings and data paths keep working. To build from source:
|
|
69
|
+
|
|
70
|
+
```sh
|
|
71
|
+
pnpm install --frozen-lockfile
|
|
72
|
+
pnpm build
|
|
73
|
+
pnpm vendor
|
|
74
|
+
node packages/cli/bin/slopie.js audit
|
|
75
|
+
```
|
|
57
76
|
|
|
58
|
-
Before upgrading
|
|
77
|
+
Before upgrading the memory store, back it up. `slopie maintain --migrate` creates a pre-upgrade backup. See the [changelog](https://github.com/HulkInTherapy/slopie/blob/main/CHANGELOG.md).
|
|
59
78
|
|
|
60
79
|
MIT licensed. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
|