chat-logbook 0.1.1 → 0.2.0
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 +22 -13
- package/package.json +4 -1
package/README.md
CHANGED
|
@@ -20,24 +20,30 @@ Browse, tag, annotate, and organize your Claude Code conversation history — al
|
|
|
20
20
|
|
|
21
21
|
### Prerequisites
|
|
22
22
|
|
|
23
|
-
- Node.js >=
|
|
23
|
+
- Node.js >= 20
|
|
24
24
|
|
|
25
25
|
### Usage
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
Install globally for a shorter command:
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
-
|
|
30
|
+
npm install -g chat-logbook
|
|
31
|
+
chat-log
|
|
31
32
|
```
|
|
32
33
|
|
|
33
|
-
Or
|
|
34
|
+
Or try without installing:
|
|
34
35
|
|
|
35
36
|
```bash
|
|
36
|
-
|
|
37
|
-
chat-log
|
|
37
|
+
npx chat-logbook@latest
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
|
|
40
|
+
You should see:
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
chat-logbook is running at http://localhost:3100
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Your browser will open automatically, showing a list of your Claude Code sessions on the left and conversation content on the right.
|
|
41
47
|
|
|
42
48
|
### Troubleshooting
|
|
43
49
|
|
|
@@ -47,6 +53,9 @@ Make sure you have Claude Code conversation history at `~/.claude/`. chat-logboo
|
|
|
47
53
|
**Port already in use**
|
|
48
54
|
By default, chat-logbook runs on port 3100. Use `PORT=8080 chat-log` to specify a different port.
|
|
49
55
|
|
|
56
|
+
**Updating to the latest version**
|
|
57
|
+
Run `npm install -g chat-logbook@latest` to update. If you use npx, the `@latest` tag ensures you always run the newest version.
|
|
58
|
+
|
|
50
59
|
## How It Works
|
|
51
60
|
|
|
52
61
|
chat-logbook reads conversation data directly from the JSONL files that Claude Code stores in `~/.claude/`. It **never modifies** these files — your original conversation data is always left untouched.
|
|
@@ -57,12 +66,6 @@ Because chat-logbook relies on what Claude Code persists to disk, **only convers
|
|
|
57
66
|
|
|
58
67
|
## FAQ
|
|
59
68
|
|
|
60
|
-
### Why can't I see my `/btw` conversations?
|
|
61
|
-
|
|
62
|
-
The `/btw` feature in Claude Code is designed to be ephemeral — questions and answers appear in a temporary overlay and are never written to conversation history files. Since chat-logbook reads from these files, `/btw` exchanges are not available.
|
|
63
|
-
|
|
64
|
-
This is by design: `/btw` is intended for quick, throwaway questions. If you want a conversation to be preserved and visible in chat-logbook, use a regular message instead of `/btw`.
|
|
65
|
-
|
|
66
69
|
### Is my data safe?
|
|
67
70
|
|
|
68
71
|
Yes. chat-logbook is fully local — no data ever leaves your machine. It only **reads** from `~/.claude/` and never modifies your original conversation files. The SQLite database it creates for your tags, annotations, and other metadata is stored separately at `~/.chat-logbook/`.
|
|
@@ -71,6 +74,12 @@ Yes. chat-logbook is fully local — no data ever leaves your machine. It only *
|
|
|
71
74
|
|
|
72
75
|
No. chat-logbook reads from local `~/.claude/` files, which are only created by the Claude Code CLI running on your machine. Conversations run via Claude Code on the web (cloud VMs) are not stored locally and are not accessible to chat-logbook.
|
|
73
76
|
|
|
77
|
+
### Why can't I see my `/btw` conversations?
|
|
78
|
+
|
|
79
|
+
The `/btw` feature in Claude Code is designed to be ephemeral — questions and answers appear in a temporary overlay and are never written to conversation history files. Since chat-logbook reads from these files, `/btw` exchanges are not available.
|
|
80
|
+
|
|
81
|
+
This is by design: `/btw` is intended for quick, throwaway questions. If you want a conversation to be preserved and visible in chat-logbook, use a regular message instead of `/btw`.
|
|
82
|
+
|
|
74
83
|
## Roadmap
|
|
75
84
|
|
|
76
85
|
- **Title editing** — Customize session titles for easier identification
|
package/package.json
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "chat-logbook",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "A local-first conversation manager for Claude Code",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
7
|
+
"engines": {
|
|
8
|
+
"node": ">=20"
|
|
9
|
+
},
|
|
7
10
|
"bin": {
|
|
8
11
|
"chat-logbook": "./bin/cli.js",
|
|
9
12
|
"chat-log": "./bin/cli.js"
|