treeship 0.9.4 → 0.9.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 +39 -17
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -1,40 +1,62 @@
|
|
|
1
1
|
# treeship
|
|
2
2
|
|
|
3
|
-
Portable
|
|
3
|
+
**Portable, cryptographically signed receipts for AI agent sessions.**
|
|
4
|
+
|
|
5
|
+
Treeship turns every AI agent session into a portable, signed receipt. Local-first. Cryptographically verifiable. Works offline. **The receipt is yours, not ours.**
|
|
4
6
|
|
|
5
7
|
## Install
|
|
6
8
|
|
|
7
9
|
```bash
|
|
8
10
|
npm install -g treeship
|
|
9
|
-
# or
|
|
10
|
-
npx treeship init
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
This package downloads the prebuilt Treeship CLI binary for your platform. No Rust required.
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
**Platform support:** macOS and Linux. Windows users: install via WSL (a native Windows binary is planned for v0.10.0). The package's `preinstall` script will exit with a clear message on Windows rather than yielding a broken install.
|
|
16
|
+
|
|
17
|
+
## Quick start
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
treeship init # one-time, per machine
|
|
21
|
+
treeship session start # opens a recording session
|
|
22
|
+
treeship wrap -- npm test # captures the command + exit code + file writes
|
|
23
|
+
treeship session close # seals the receipt
|
|
24
|
+
treeship session report # uploads + prints a shareable URL
|
|
25
|
+
treeship verify <url> # anyone can verify, offline, no account
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Claude Code users
|
|
29
|
+
|
|
30
|
+
If you're using Claude Code, install the plugin instead — it auto-records every session via SessionStart / PostToolUse / SessionEnd hooks, no manual `session start` to remember:
|
|
16
31
|
|
|
17
32
|
```bash
|
|
18
|
-
treeship
|
|
19
|
-
|
|
20
|
-
treeship verify last --full
|
|
21
|
-
treeship dock push <artifact-id>
|
|
33
|
+
claude plugin marketplace add zerkerlabs/treeship
|
|
34
|
+
claude plugin install treeship@treeship
|
|
22
35
|
```
|
|
23
36
|
|
|
24
|
-
## What
|
|
37
|
+
## What gets captured
|
|
38
|
+
|
|
39
|
+
`@treeship/mcp` and the Claude Code plugin capture:
|
|
40
|
+
|
|
41
|
+
- Tool name (e.g. `read_file`, `bash`)
|
|
42
|
+
- SHA-256 digest of arguments — **not the raw arguments**
|
|
43
|
+
- SHA-256 digest of output content — **not the raw content**
|
|
44
|
+
- Exit code, duration, error message text on failures
|
|
45
|
+
- Actor URI (e.g. `agent://claude-code`)
|
|
46
|
+
|
|
47
|
+
What's **not** captured: raw argument values, raw output content, file contents, environment variable values, secrets. Full inventory at <https://github.com/zerkerlabs/treeship/blob/main/TREESHIP.md>.
|
|
25
48
|
|
|
26
|
-
|
|
49
|
+
## Where data lives
|
|
27
50
|
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
- **Merkle checkpoints** for batch integrity
|
|
32
|
-
- **WASM verification** in the browser
|
|
33
|
-
- **Templates** for common workflows
|
|
51
|
+
- Receipts stay in `.treeship/sessions/<id>.treeship` on your machine
|
|
52
|
+
- They leave only on explicit `treeship session report`, `treeship hub push`, or with `auto_push: true` configured
|
|
53
|
+
- Verification (`treeship package verify`) is pure WASM, runs entirely offline, doesn't phone home
|
|
34
54
|
|
|
35
55
|
## Documentation
|
|
36
56
|
|
|
37
|
-
https://docs.treeship.dev
|
|
57
|
+
- Full docs: <https://docs.treeship.dev>
|
|
58
|
+
- Trust model + complete capture inventory: <https://github.com/zerkerlabs/treeship/blob/main/TREESHIP.md>
|
|
59
|
+
- Source: <https://github.com/zerkerlabs/treeship>
|
|
38
60
|
|
|
39
61
|
## License
|
|
40
62
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "treeship",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.5",
|
|
4
4
|
"description": "Portable trust receipts for agent workflows",
|
|
5
5
|
"bin": {
|
|
6
6
|
"treeship": "./bin/treeship.js"
|
|
@@ -19,9 +19,9 @@
|
|
|
19
19
|
"linux"
|
|
20
20
|
],
|
|
21
21
|
"optionalDependencies": {
|
|
22
|
-
"@treeship/cli-linux-x64": "0.9.
|
|
23
|
-
"@treeship/cli-darwin-arm64": "0.9.
|
|
24
|
-
"@treeship/cli-darwin-x64": "0.9.
|
|
22
|
+
"@treeship/cli-linux-x64": "0.9.5",
|
|
23
|
+
"@treeship/cli-darwin-arm64": "0.9.5",
|
|
24
|
+
"@treeship/cli-darwin-x64": "0.9.5"
|
|
25
25
|
},
|
|
26
26
|
"license": "Apache-2.0",
|
|
27
27
|
"repository": {
|