chat-logbook 0.9.0 → 0.11.0

package/README.md

@@ -2,77 +2,46 @@
 
 > _Where your AI conversations live._
 
-A local-first library for the conversations you've had with your AI tools.
-Read by chat-logbook, kept on your machine, browsable and searchable in one
-place — even after your AI tool has deleted the original.
+A local-first library for the conversations you've had with your AI tools. Read by chat-logbook, kept on your machine, browsable and searchable in one place — even after your AI tool has deleted the original.
 
-> **Status.** A personal side project, moving at side-project pace —
-> development and responses happen as time allows. Early release:
-> browsing, rendering, soft-delete, and a local archive that survives
-> vendor cleanup all work today. Search and tags are next. See
-> [Roadmap](#roadmap).
+> **Status.** A personal side project, moving at side-project pace — development and responses happen as time allows. Early release: browsing, rendering, soft-delete, and a local archive that survives vendor cleanup all work today. Search and tags are next. See [Roadmap](#roadmap).
 
 ## What chat-logbook is
 
-You open it from the command line, and a browser window opens onto your
-conversation history. You can browse it, find anything in it, tag what
-matters, and pick up where you left off.
+You open it from the command line, and a browser window opens onto your conversation history. You can browse it, find anything in it, tag what matters, and pick up where you left off.
 
-It reads the files your AI tools already write to your machine — Claude Code
-today, with more tools planned. From there it keeps its own copy in a
-private archive on your machine, so the history is yours even when the
-source tool quietly cleans up after itself (Claude Code defaults to deleting
-conversations older than 30 days).
+It reads the files your AI tools already write to your machine — Claude Code today, with more tools planned. From there it keeps its own copy in a private archive on your machine, so the history is yours even when the source tool quietly cleans up after itself (Claude Code defaults to deleting conversations older than 30 days).
 
 Nothing leaves your machine. There is no account to create. The original
 files your AI tools wrote are never modified.
 
-We built this because the right place for your AI conversations to live
-isn't inside the next vendor change.
+We built this because the right place for your AI conversations to live isn't inside the next vendor change.
 
 ## What it gives you
 
-- **Read-only access to source directories.** Original conversation files
-  are never modified. Today that means `~/.claude/`; the same rule applies
-  to every agent we add.
+- **Read-only access to source directories.** Original conversation files are never modified. Today that means `~/.claude/`; the same rule applies to every agent we add.
 - **Local-only.** No telemetry, no analytics, no third-party calls.
 - **Zero configuration.** Install and run.
-- **Drive everything from the keyboard.** A `/` or `⌘K` overlay finds any
-  past conversation in seconds. The mouse still works, but every primary
-  action has a binding.
-- **Your archive is yours.** It's a single SQLite file at
-  `~/.chat-logbook/archive.db`. Copy it to back up. Open it with any tool
-  that reads SQLite. If chat-logbook disappears tomorrow, the archive
-  doesn't.
+- **Drive everything from the keyboard.** A `/` or `⌘K` overlay finds any past conversation in seconds. The mouse still works, but every primary action has a binding.
+- **Your archive is yours.** It's a single SQLite file at `~/.chat-logbook/archive.db`. Copy it to back up. Open it with any tool that reads SQLite. If chat-logbook disappears tomorrow, the archive doesn't.
 
-The full problem statement, user stories, and direction live in the
-[PRD](docs/PRD.md).
+The full problem statement, user stories, and direction live in the [PRD](docs/PRD.md).
 
 ## What works today
 
 - **Three-column layout.** Resizable panels for filters, chat list,
   and conversation content.
-- **Rich conversation rendering.** Markdown, syntax-highlighted code
-  blocks, collapsible tool calls with one-line summaries, and collapsible
-  thinking blocks.
+- **Rich conversation rendering.** Markdown, syntax-highlighted code blocks, collapsible tool calls with one-line summaries, and collapsible thinking blocks.
 - **Virtual scrolling.** Long conversations scroll smoothly.
 - **Solarized Dark theme.** Easy on the eyes, consistent with Claude
   Code's terminal look.
 - **Soft delete with Trash.** Hide chats you don't want to see; restore
   them anytime.
-- **Custom chat titles.** Rename any chat — click its title in the
-  list or conversation header, or select it and press `F2` / `↵`. Clear
-  the title to fall back to the first message.
-- **Local archive.** Every conversation chat-logbook reads is copied into
-  `~/.chat-logbook/archive.db`. The UI reads from the archive, so a
-  chat stays visible even after the source JSONL is gone.
-- **Live updates.** While Claude Code is actively writing to a chat,
-  new messages appear in chat-logbook within seconds — no restart
-  needed.
-- **Chat metadata at a glance.** A ⓘ button on the conversation
-  header opens a popover showing when the chat started, when it was
-  last updated, the agent, the project working directory, and the
-  chat's IDs — with one-click copy.
+- **Sortable lists.** Sort your chats by title, created time, or updated time, and the choice sticks between visits. Trash sorts independently — by deleted time by default.
+- **Custom chat titles.** Rename any chat — click its title in the list or conversation header, or select it and press `F2` / `↵`. Clear the title to fall back to the first message.
+- **Local archive.** Every conversation chat-logbook reads is copied into `~/.chat-logbook/archive.db`. The UI reads from the archive, so a chat stays visible even after the source JSONL is gone.
+- **Live updates.** While Claude Code is actively writing to a chat, new messages appear in chat-logbook within seconds — no restart needed.
+- **Chat metadata at a glance.** A ⓘ button on the conversation header opens a popover showing when the chat started, when it was last updated, the agent, the project working directory, and the chat's IDs — with one-click copy.
 
 ## Quick start
 
@@ -97,93 +66,60 @@ You should see:
 chat-logbook is running at http://localhost:3100
 ```
 
-A browser window opens automatically, showing a list of your Claude Code
-chats on the left and conversation content on the right.
+A browser window opens automatically, showing a list of your Claude Code chats on the left and conversation content on the right.
 
 ### Troubleshooting
 
 **"No conversations found."**
-You need to have Claude Code conversation history at `~/.claude/`.
-chat-logbook reads from this directory automatically.
+You need to have Claude Code conversation history at `~/.claude/`. chat-logbook reads from this directory automatically.
 
 **"Port already in use."**
-chat-logbook runs on port 3100 by default. Use `chat-log --port 8080`
-(or `PORT=8080 chat-log`) to pick a different port.
+chat-logbook runs on port 3100 by default. Use `chat-log --port 8080` (or `PORT=8080 chat-log`) to pick a different port.
 
 **Updating to the latest version.**
-Run `npm install -g chat-logbook@latest`. If you use npx, the `@latest`
-tag ensures you always run the newest version.
+Run `npm install -g chat-logbook@latest`. If you use npx, the `@latest` tag ensures you always run the newest version.
 
 ## FAQ
 
 ### Does chat-logbook work with Claude Code on the web?
 
-No. chat-logbook reads from local `~/.claude/` files, which are only
-created by the Claude Code CLI on your machine. Conversations run via
-Claude Code on the web (cloud VMs) are not stored locally and aren't
-visible to chat-logbook.
+No. chat-logbook reads from local `~/.claude/` files, which are only created by the Claude Code CLI on your machine. Conversations run via Claude Code on the web (cloud VMs) are not stored locally and aren't visible to chat-logbook.
 
 ### Why can't I see my `/btw` conversations?
 
-`/btw` is designed to be ephemeral — questions and answers appear in a
-temporary overlay and are never written to conversation history files.
-For a conversation to be preserved and visible in chat-logbook, send a
-regular message instead.
+`/btw` is designed to be ephemeral — questions and answers appear in a temporary overlay and are never written to conversation history files. For a conversation to be preserved and visible in chat-logbook, send a regular message instead.
 
 ### Will chat-logbook lose my history if Claude Code deletes its files?
 
-Once chat-logbook has read a conversation into its archive, vendor
-cleanup of the original file no longer removes it from chat-logbook.
-The archive's contract: never delete in response to source deletion.
-Only an explicit user action (Hard Delete / Purge) removes archived
-conversations.
+Once chat-logbook has read a conversation into its archive, vendor cleanup of the original file no longer removes it from chat-logbook. The archive's contract: never delete in response to source deletion. Only an explicit user action (Hard Delete / Purge) removes archived conversations.
 
 ### Where is my data stored?
 
 Three places, all on your machine:
 
 - `~/.claude/` (and equivalents for other tools) — read-only source.
-- `~/.chat-logbook/archive.db` — chat-logbook's copy of the
-  conversations it has read.
-- `~/.chat-logbook/data.db` — your tags, titles, annotations, and
-  soft-delete flags.
+- `~/.chat-logbook/archive.db` — chat-logbook's copy of the conversations it has read.
+- `~/.chat-logbook/metadata.db` — your tags, titles, annotations, and soft-delete flags.
 
-Back up the two `~/.chat-logbook/` files together; they are the
-complete chat-logbook state.
+Back up the two `~/.chat-logbook/` files together; they are the complete chat-logbook state.
 
 ### Is this affiliated with Anthropic / OpenAI?
 
-No. chat-logbook reads files those tools write on your machine. It
-doesn't talk to their servers and isn't endorsed by them.
+No. chat-logbook reads files those tools write on your machine. It doesn't talk to their servers and isn't endorsed by them.
 
 ## Roadmap
 
 Two phases of work are in flight, in this order.
 
-**Custom titles and tags.** Rename a chat to something you'll
-recognize, attach tags with custom colors, and filter the list by tag or
-by project. This is the path from "I have a lot of conversations" to
-"I can find the one I need."
+**Custom titles and tags.** Rename a chat to something you'll recognize, attach tags with custom colors, and filter the list by tag or by project. This is the path from "I have a lot of conversations" to "I can find the one I need."
 
-**Spotlight search.** A keyboard-driven overlay (`⌘K` or `/`) that
-searches across chats, messages, tags, and projects from one input.
-A match lands you on the exact message with the term highlighted, and
-you can jump between every match without leaving the overlay.
+**Spotlight search.** A keyboard-driven overlay (`⌘K` or `/`) that searches across chats, messages, tags, and projects from one input. A match lands you on the exact message with the term highlighted, and you can jump between every match without leaving the overlay.
 
-Beyond these three, several smaller things are on the list without firm
-timing — live updates while an AI tool is writing, annotations and
-highlights for marking what matters, editing your own past messages,
-CLI commands for working with conversations from a terminal. Some will
-ship; some are still being weighed.
+Beyond these three, several smaller things are on the list without firm timing — live updates while an AI tool is writing, annotations and highlights for marking what matters, editing your own past messages, CLI commands for working with conversations from a terminal. Some will ship; some are still being weighed.
 
-Explicit non-goals: semantic / vector search, cloud sync inside the OSS
-core, modification of source directories like `~/.claude/`, and bulk
-export to bespoke formats (the archive itself is the export). See the
-[PRD](docs/PRD.md) for the full out-of-scope list.
+Explicit non-goals: semantic / vector search, cloud sync inside the OSS core, modification of source directories like `~/.claude/`, and bulk export to bespoke formats (the archive itself is the export). See the [PRD](docs/PRD.md) for the full out-of-scope list.
 
-This project is **not affiliated with Anthropic, OpenAI, or any other AI
-provider.** It reads files those tools write on your machine; it does
-not talk to their servers and is not endorsed by them.
+This project is **not affiliated with Anthropic, OpenAI, or any other AI provider.** It reads files those tools write on your machine; it does not talk to their servers and is not endorsed by them.
 
 ## Changelog
 
@@ -191,20 +127,14 @@ See [CHANGELOG.md](CHANGELOG.md) for release notes.
 
 ## Contributing
 
-Chat Logbook is in very early development. To keep focus on the current
-goals, we're not taking contributions right now.
+Chat Logbook is in very early development. To keep focus on the current goals, we're not taking contributions right now.
 
-If there's something you really need — or you'd genuinely like to help —
-reach out directly and we can talk through it.
+If there's something you really need — or you'd genuinely like to help — reach out directly and we can talk through it.
 
 ## License
 
-This project is licensed under the
-[GNU Affero General Public License v3.0](LICENSE) (AGPL-3.0-only).
+This project is licensed under the [GNU Affero General Public License v3.0](LICENSE) (AGPL-3.0-only).
 
-You are free to use, modify, and distribute this software under the
-terms of the AGPL-3.0. If you modify the program and make it available
-over a network, you must release your modified source code under the
-same license.
+You are free to use, modify, and distribute this software under the terms of the AGPL-3.0. If you modify the program and make it available over a network, you must release your modified source code under the same license.
 
 For commercial licensing inquiries, contact the author.

package/api/dist/drizzle/0003_add_deleted_at.sql

@@ -0,0 +1,2 @@
+ALTER TABLE `chats_meta` ADD `deleted_at` integer;--> statement-breakpoint
+UPDATE `chats_meta` SET `deleted_at` = `updated_at` WHERE `is_deleted` = 1;

package/api/dist/drizzle/archive/0007_drop_session_scan_state.sql

@@ -0,0 +1,2 @@
+DROP INDEX IF EXISTS `session_scan_state_idx`;--> statement-breakpoint
+DROP TABLE IF EXISTS `session_scan_state`;

package/api/dist/drizzle/archive/meta/_journal.json

@@ -50,6 +50,13 @@
       "when": 1779100000000,
       "tag": "0006_add_project_path",
       "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "6",
+      "when": 1779200000000,
+      "tag": "0007_drop_session_scan_state",
+      "breakpoints": true
     }
   ]
 }

package/api/dist/drizzle/checkpoint/0000_sour_zeigeist.sql

@@ -0,0 +1,11 @@
+CREATE TABLE `chat_scan_state` (
+	`id` integer PRIMARY KEY AUTOINCREMENT NOT NULL,
+	`agent` text NOT NULL,
+	`source_id` text NOT NULL,
+	`source_path` text NOT NULL,
+	`last_mtime_ms` integer NOT NULL,
+	`last_size_bytes` integer NOT NULL,
+	`last_scanned_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `chat_scan_state_idx` ON `chat_scan_state` (`agent`,`source_id`);

package/api/dist/drizzle/checkpoint/meta/0000_snapshot.json

@@ -0,0 +1,83 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "7000812a-0b76-46c3-a086-0b2a551fe473",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "tables": {
+    "chat_scan_state": {
+      "name": "chat_scan_state",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "agent": {
+          "name": "agent",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "source_id": {
+          "name": "source_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "source_path": {
+          "name": "source_path",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_mtime_ms": {
+          "name": "last_mtime_ms",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_size_bytes": {
+          "name": "last_size_bytes",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "last_scanned_at": {
+          "name": "last_scanned_at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "chat_scan_state_idx": {
+          "name": "chat_scan_state_idx",
+          "columns": ["agent", "source_id"],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/api/dist/drizzle/checkpoint/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1781328041144,
+      "tag": "0000_sour_zeigeist",
+      "breakpoints": true
+    }
+  ]
+}

package/api/dist/drizzle/meta/_journal.json

@@ -22,6 +22,13 @@
       "when": 1779000000000,
       "tag": "0002_rename_sessions_meta_to_chats_meta",
       "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1779500000000,
+      "tag": "0003_add_deleted_at",
+      "breakpoints": true
     }
   ]
 }