ckforensics 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 +40 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -37,30 +37,56 @@ curl -L https://github.com/phong28zk/ckforensics/releases/latest/download/ckfore
|
|
|
37
37
|
-o /usr/local/bin/ckforensics && chmod +x /usr/local/bin/ckforensics
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
Platforms: `linux-x64`, `linux-arm64`, `macos-
|
|
40
|
+
Platforms: `linux-x64`, `linux-arm64`, `macos-arm64` (Apple Silicon), `windows-x64`
|
|
41
|
+
|
|
42
|
+
> Intel Mac users: build from source — `bun build --compile --target=bun-darwin-x64 src/cli/index.ts --outfile ckforensics`
|
|
41
43
|
|
|
42
44
|
---
|
|
43
45
|
|
|
44
46
|
## Quick Start
|
|
45
47
|
|
|
46
48
|
```bash
|
|
47
|
-
# 1. Ingest all sessions from
|
|
49
|
+
# 1. Ingest all sessions from ~/.claude/projects/
|
|
48
50
|
ckforensics ingest
|
|
49
51
|
|
|
50
|
-
# 2. Summarize recent sessions
|
|
51
|
-
ckforensics summary
|
|
52
|
+
# 2. Summarize recent sessions (default 7 days)
|
|
53
|
+
ckforensics summary
|
|
54
|
+
ckforensics summary --days 1 # today
|
|
55
|
+
ckforensics summary --days 30 # month
|
|
56
|
+
|
|
57
|
+
# 3. List recent sessions
|
|
58
|
+
ckforensics sessions --limit 10
|
|
52
59
|
|
|
53
|
-
#
|
|
54
|
-
ckforensics audit --
|
|
60
|
+
# 4. Audit the most recent session (markdown manifest)
|
|
61
|
+
ckforensics audit --last
|
|
62
|
+
ckforensics audit <session-id> --out review.md
|
|
55
63
|
|
|
56
|
-
#
|
|
57
|
-
ckforensics
|
|
64
|
+
# 5. Redact secrets from a file before sharing
|
|
65
|
+
ckforensics redact review.md --in-place
|
|
58
66
|
|
|
59
|
-
#
|
|
67
|
+
# 6. Export for scripting
|
|
68
|
+
ckforensics export summary --format json | jq
|
|
69
|
+
ckforensics export sessions --format csv --out sessions.csv
|
|
70
|
+
|
|
71
|
+
# 7. Health check
|
|
60
72
|
ckforensics doctor
|
|
61
73
|
```
|
|
62
74
|
|
|
63
|
-
>
|
|
75
|
+
> DB stored at XDG-compliant path (mode `0600`):
|
|
76
|
+
> - Linux: `~/.local/share/ckforensics/store.db`
|
|
77
|
+
> - macOS: `~/Library/Application Support/ckforensics/store.db`
|
|
78
|
+
> - Windows: `%APPDATA%\ckforensics\store.db`
|
|
79
|
+
>
|
|
80
|
+
> Nothing leaves your machine. Run `ckforensics path` to see resolved paths.
|
|
81
|
+
|
|
82
|
+
### About cost numbers
|
|
83
|
+
|
|
84
|
+
Cost shown is **API-rate equivalent** computed from token counts × Anthropic published prices ([Nov 2025 snapshot](https://platform.claude.com/docs/en/about-claude/pricing)).
|
|
85
|
+
|
|
86
|
+
- **API users:** approximates your actual bill (±10-30% for cache-pricing edge cases)
|
|
87
|
+
- **Subscription users (Pro / Max / Team):** flat plan fee covers this; treat the number as **"value extracted"** from your subscription
|
|
88
|
+
|
|
89
|
+
Example: a 14h Opus 4.7 session showing `$166` means you'd pay ~$166 at API rates — your $100/mo Max plan covers it with positive ROI.
|
|
64
90
|
|
|
65
91
|
---
|
|
66
92
|
|
|
@@ -77,12 +103,12 @@ ckforensics doctor
|
|
|
77
103
|
| Feature | ckforensics | ccusage | Native CC |
|
|
78
104
|
|---------|:-----------:|:-------:|:---------:|
|
|
79
105
|
| Local SQLite storage | ✅ | ✅ | ❌ |
|
|
106
|
+
| Version-aware cost pricing | ✅ | 🟡 | ✅ (live only) |
|
|
80
107
|
| Token usage analytics | ✅ | ✅ | ❌ |
|
|
81
108
|
| Secret redaction (9 rules) | ✅ | ❌ | ❌ |
|
|
82
|
-
| Session
|
|
83
|
-
| Subagent
|
|
84
|
-
| Markdown / JSON export | ✅ | ❌ | ❌ |
|
|
85
|
-
| Diff between sessions | ✅ | ❌ | ❌ |
|
|
109
|
+
| Session change manifest (diff + reasoning) | ✅ | ❌ | ❌ |
|
|
110
|
+
| Subagent attribution | ✅ | ❌ | ❌ |
|
|
111
|
+
| Markdown / JSON / CSV export | ✅ | ❌ | ❌ |
|
|
86
112
|
| Offline / no telemetry | ✅ | ✅ | ✅ |
|
|
87
113
|
| Cross-platform binaries | ✅ | ❌ | ✅ |
|
|
88
114
|
|