@cocaxcode/logbook-mcp 0.4.9 → 0.4.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cocaxcode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
   <h1 align="center">@cocaxcode/logbook-mcp</h1>
   <p align="center">
     <strong>Your developer logbook, always one sentence away.</strong><br/>
-    Notes &middot; TODOs &middot; Reminders &middot; Code TODOs &middot; Full-text search &middot; Zero config
+    Notes &middot; TODOs &middot; Reminders &middot; Code scanning &middot; Full-text search &middot; Zero config
   </p>
 </p>
 
@@ -12,45 +12,80 @@
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="License" /></a>
   <img src="https://img.shields.io/badge/node-%3E%3D20-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node" />
   <img src="https://img.shields.io/badge/tools-9-blueviolet?style=flat-square" alt="9 tools" />
-  <img src="https://img.shields.io/badge/tests-63-brightgreen?style=flat-square" alt="63 tests" />
 </p>
 
 <p align="center">
-  <a href="#the-problem">The Problem</a> &middot;
-  <a href="#installation">Installation</a> &middot;
+  <a href="#quick-overview">Overview</a> &middot;
   <a href="#just-talk-to-it">Usage</a> &middot;
+  <a href="#installation">Installation</a> &middot;
   <a href="#features">Features</a> &middot;
-  <a href="#reminders">Reminders</a> &middot;
   <a href="#tool-reference">Tool Reference</a> &middot;
   <a href="#storage">Storage</a> &middot;
-  <a href="#contributing">Contributing</a>
+  <a href="#architecture">Architecture</a>
 </p>
 
 ---
 
-## The Problem
+## Quick Overview
 
-You make decisions every day. Why JWT over sessions? Why Redis over Memcached? Why that specific database schema?
+logbook-mcp is an MCP server that turns your AI assistant into a persistent developer logbook. Capture decisions, track TODOs, set reminders, and search everything — without leaving your editor.
 
-**Nobody writes it down.** Three months later, you ask yourself _"why did we do this?"_ — and the answer is gone.
+It auto-detects your git project, stores everything in a local SQLite database, and works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex CLI, or Gemini CLI.
 
-Your TODOs live in 5 different places: Jira, sticky notes, code comments, your head, and that Slack message you'll never find again.
+---
+
+## Just Talk to It
 
-**logbook-mcp** is a developer logbook that lives inside your AI assistant. Notes, TODOs, reminders, and code TODOs — all queryable with natural language, without ever leaving your workflow.
+No commands to memorize. Just say what you need.
 
-### Why logbook-mcp?
+### Capture notes
+
+```
+"I decided to use JWT instead of sessions for scalability"
+→ Saved as a decision — retrievable months from now
+
+"The CI is failing due to a timeout in integration tests"
+→ Captured as a blocker — shows up when you review activity
+```
 
-| Feature | Benefit |
-|---------|---------|
-| **Zero context switching** | Don't leave Claude/Cursor to open another app |
-| **Zero config** | Auto-detects your project, creates the DB on first use |
-| **Zero AI costs** | Returns raw data, your AI client does the formatting |
-| **Captures what git doesn't** | Decisions, ideas, blockers, reminders, and context |
-| **Code TODOs included** | Scans your source for `TODO/FIXME/HACK/BUG` automatically |
-| **Auto-sync code TODOs** | Detects when code TODOs disappear (you fixed them) |
-| **Full-text search** | FTS5 powered, finds anything instantly |
-| **Recurring reminders** | Daily, weekly, monthly patterns with auto-ack |
-| **Multi-project** | One database, all your projects, query per-project or globally |
+### Track TODOs
+
+```
+"TODO: implement email validation"
+→ Created with auto-inferred topic
+
+"Add these: fix token refresh. update deps. add rate limiting"
+→ 3 TODOs created at once, each categorized
+
+"Mark 5 and 8 as done"
+→ Both completed
+
+"What's pending across all projects?"
+→ Global view of everything, including code TODOs
+```
+
+### Set reminders
+
+```
+"Remind me tomorrow to deploy"
+→ One-time reminder
+
+"Remind me every Tuesday to review PRs"
+→ Recurring weekly — auto-acknowledged after each session
+
+"Remind me on weekdays to check the CI"
+→ Monday to Friday
+```
+
+### Search anything
+
+```
+"Why did we choose JWT?"
+→ Finds the decision note, even months later
+
+"Search everything about auth"
+→ FTS5 search across all notes and TODOs
+```
 
 ---
 
@@ -85,9 +120,10 @@ Add to your `claude_desktop_config.json`:
 - **Linux**: `~/.config/Claude/claude_desktop_config.json`
 </details>
 
-### Cursor
+<details>
+<summary>Cursor, Windsurf, VS Code, Codex CLI, Gemini CLI</summary>
 
-Add to `.cursor/mcp.json` in your project:
+**Cursor** — add to `.cursor/mcp.json`:
 
 ```json
 {
@@ -100,9 +136,7 @@ Add to `.cursor/mcp.json` in your project:
 }
 ```
 
-### Windsurf
-
-Add to `.windsurf/mcp.json`:
+**Windsurf** — add to `.windsurf/mcp.json`:
 
 ```json
 {
@@ -115,9 +149,7 @@ Add to `.windsurf/mcp.json`:
 }
 ```
 
-### VS Code
-
-Add to `.vscode/mcp.json`:
+**VS Code** — add to `.vscode/mcp.json`:
 
 ```json
 {
@@ -130,15 +162,13 @@ Add to `.vscode/mcp.json`:
 }
 ```
 
-### Codex CLI
+**Codex CLI**:
 
 ```bash
 codex mcp add logbook-mcp -- npx @cocaxcode/logbook-mcp@latest --mcp
 ```
 
-### Gemini CLI
-
-Add to `.gemini/settings.json`:
+**Gemini CLI** — add to `.gemini/settings.json`:
 
 ```json
 {
@@ -151,125 +181,67 @@ Add to `.gemini/settings.json`:
 }
 ```
 
----
-
-## Just Talk to It
-
-No commands to memorize. Just tell your AI what you need:
-
-### Notes — capture what matters
-
-| You say | What happens |
-|---------|-------------|
-| *"I decided to use JWT instead of sessions for scalability"* | Saved as **decision** — retrievable months from now |
-| *"Note: Redis doesn't support nested JSON queries natively"* | Saved as a note for future reference |
-| *"The CI is failing due to a timeout in integration tests"* | Captured as **blocker** — shows up in standups |
-| *"We could add WebSocket support for real-time updates"* | Saved as **idea** — won't get lost in Slack |
-
-### TODOs — your checklist, always at hand
-
-| You say | What happens |
-|---------|-------------|
-| *"TODO: implement email validation"* | Created with topic **feature** (AI infers it) |
-| *"Add these: fix token refresh. update deps. add rate limiting"* | **3 TODOs** created at once, each categorized |
-| *"Mark 5 and 8 as done"* | Both marked as completed |
-| *"What's pending?"* | All TODOs grouped by topic, including code TODOs |
-| *"What's pending across all projects?"* | Global view of everything |
-
-### Reminders — never forget
-
-| You say | What happens |
-|---------|-------------|
-| *"Remind me tomorrow to deploy"* | One-time reminder for tomorrow |
-| *"Remind me every Tuesday to review PRs"* | Recurring weekly reminder |
-| *"Remind me the 1st of each month to renew certificates"* | Monthly recurring reminder |
-| *"Remind me on weekdays to check the CI"* | Monday to Friday reminder |
-
-### Search — find anything, instantly
-
-| You say | What happens |
-|---------|-------------|
-| *"What did I do yesterday?"* | Notes + completed TODOs from yesterday |
-| *"Search everything about auth"* | FTS5 search across all notes and TODOs |
-| *"Show me all decisions this month"* | Filtered by topic **decision** and date range |
-| *"Why did we choose JWT?"* | Finds the decision note, even months later |
+</details>
 
 ---
 
 ## Features
 
-### Smart project detection
-
-logbook-mcp auto-detects which git project you're in. No setup, no config files:
-
-```
-You're in ~/projects/my-api/
-  → "What's pending?" shows only my-api TODOs
-
-You're in ~/projects/my-frontend/
-  → Same question shows only my-frontend TODOs
-
-You ask "all projects"
-  → Global view across everything
-```
-
 ### 7 built-in topics
 
-Every note, TODO, and reminder is categorized. The AI infers the topic automatically, or you can specify it:
+Every note, TODO, and reminder is categorized automatically by your AI, or you can specify a topic explicitly.
 
-| Topic | Purpose | Auto-mapped from commits | AI infers from |
-|-------|---------|:------------------------:|----------------|
-| **feature** | New functionality | `feat:` | "implement", "add", "create" |
-| **fix** | Bug fixes | `fix:` | "fix", "bug", "broken" |
-| **chore** | Maintenance, CI/CD, refactoring | `refactor:` `docs:` `ci:` `build:` `test:` | "update", "clean", "refactor" |
-| **idea** | Future proposals | — | "maybe", "could", "explore" |
-| **decision** | Architecture choices | — | "decided", "chose", "going with" |
-| **blocker** | Things blocking progress | — | "blocked", "can't", "waiting" |
-| **reminder** | Time-based reminders | — | Auto-assigned when `remind_at` is set |
+| Topic | Purpose | Mapped from conventional commits |
+|-------|---------|:--------------------------------:|
+| **feature** | New functionality | `feat:` |
+| **fix** | Bug fixes | `fix:` |
+| **chore** | Maintenance, CI/CD, refactoring | `refactor:` `docs:` `ci:` `build:` `test:` |
+| **idea** | Future proposals | — |
+| **decision** | Architecture choices | — |
+| **blocker** | Things blocking progress | — |
+| **reminder** | Time-based reminders | — |
 
-Topics are auto-created when the AI uses one that doesn't exist. You can also create custom topics:
+Custom topics can be created at any time — just say *"create a topic called security"*.
 
-```
-"Create a topic called 'security'"
-→ Done. Now you can tag notes and TODOs with 'security'.
-```
+### Code TODO scanning
 
-### TODOs as checklist
+Your `TODO`, `FIXME`, `HACK`, and `BUG` comments are detected via `git grep` and shown alongside manual TODOs:
 
-Manual TODOs with priority levels:
+```
+feature (2)
+  [ ] #12 [manual] Implement email validation
+      [code]  TODO: add OAuth support — src/auth/service.ts:45
 
+fix (3)
+  [ ] #8  [manual] Token doesn't refresh
+      [code]  FIXME: handle null case — src/users/controller.ts:78
+      [code]  BUG: race condition — src/chat/gateway.ts:112
 ```
-📋 feature (3)
-  ☐ #12 Implement email validation
-  ☐ #15 [HIGH] Dynamic permissions endpoint
-  ☑ #9  Google OAuth login (completed Mar 17)
 
-📋 fix (1)
-  ☐ #8  [URGENT] Token doesn't refresh
+When a code TODO disappears from source (because you fixed it), logbook detects it automatically and marks it as resolved.
 
-📋 blocker (1)
-  ☐ #20 Resolve CI timeout
-```
+### Reminders
 
-### Code TODOs — live from your source
+Both one-time and recurring patterns are supported:
 
-Your `TODO`, `FIXME`, `HACK`, and `BUG` comments appear alongside manual TODOs:
+| Pattern | Example | Schedule |
+|---------|---------|----------|
+| One-time | `remind_at: "2026-03-25"` | March 25 only |
+| `daily` | Every day | Every day |
+| `weekdays` | Monday to Friday | Mon–Fri |
+| `weekly:2` | Every Tuesday | Specific day of week |
+| `weekly:1,3` | Monday and Wednesday | Multiple days |
+| `monthly:1` | 1st of each month | Specific day of month |
+| `monthly:1,15` | 1st and 15th | Multiple days |
 
-```
-📋 feature (2)
-  ☐ #12 [manual] Implement email validation
-  📄 [code]  TODO: add OAuth support — src/auth/service.ts:45
+Recurring reminders auto-acknowledge after being shown once per day. One-time reminders that were missed show as overdue.
 
-📋 fix (3)
-  ☐ #8  [manual] Token doesn't refresh
-  📄 [code]  FIXME: handle null case — src/users/controller.ts:78
-  📄 [code]  BUG: race condition — src/chat/gateway.ts:112
+> [!TIP]
+> logbook-mcp exposes an MCP Resource (`logbook://reminders`) that clients can load on session start. In Claude Code and Claude Desktop, reminders appear automatically without asking. In other clients, just say *"any reminders?"*.
 
-📋 chore (1)
-  📄 [code]  HACK: proxy workaround — src/middleware/cors.ts:23
-```
+### Full-text search (FTS5)
 
-**Auto-sync:** When you fix a code TODO and it disappears from the source, logbook detects it and marks it as resolved. No action needed — it happens automatically when you list your TODOs.
+Search across all notes and TODOs instantly, powered by SQLite FTS5. Filter by topic, type, project, or search globally across all projects.
 
 ### Batch operations
 
@@ -279,179 +251,9 @@ Your `TODO`, `FIXME`, `HACK`, and `BUG` comments appear alongside manual TODOs:
 "Delete TODOs 3 and 7"                             → 2 TODOs removed
 ```
 
-### Full-text search (FTS5)
-
-Instant search across all notes and TODOs, powered by SQLite FTS5:
-
-```
-"Search auth"
-→ Finds notes about JWT decisions, TODOs about auth endpoints,
-  and anything mentioning "auth" — across all projects if you want
-```
-
----
-
-## Reminders
-
-logbook-mcp supports both one-time and recurring reminders.
-
-### One-time reminders
-
-```
-"Remind me tomorrow to deploy to production"
-→ remind_at: "2026-03-20", topic: "reminder"
-
-"Remind me on March 25 to review the quarterly report"
-→ remind_at: "2026-03-25", topic: "reminder"
-```
-
-### Recurring reminders
-
-| You say | Pattern | When it fires |
-|---------|---------|---------------|
-| *"Remind me every day to check CI"* | `daily` | Every day |
-| *"Remind me on weekdays to do standup"* | `weekdays` | Monday to Friday |
-| *"Remind me every Tuesday to review PRs"* | `weekly:2` | Every Tuesday |
-| *"Remind me Mondays and Wednesdays to sync"* | `weekly:1,3` | Mon + Wed |
-| *"Remind me the 1st of each month to renew certs"* | `monthly:1` | 1st of month |
-| *"Remind me the 1st and 15th to check billing"* | `monthly:1,15` | 1st + 15th |
-
-### How reminders behave
-
-```
-Tuesday 9:00 — you open Claude
-  ⏰ Reminder: review PRs (weekly, every Tuesday)
-  → Shows once, auto-acknowledged for today
-
-Tuesday 14:00 — you open Claude again
-  → Nothing. Already shown today.
-
-Wednesday — you open Claude
-  → Nothing. Not a Tuesday.
-
-Next Tuesday — you open Claude
-  → ⏰ Reminder: review PRs (shows again)
-```
-
-**To stop a recurring reminder permanently:** delete it with `logbook_todo_rm`.
-
-### Overdue reminders
-
-One-time reminders that weren't completed show as overdue:
-
-```
-⏰ Reminders for today (Mar 19)
-  my-api: deploy to production
-
-⚠️ Overdue
-  my-frontend: fix dark mode (was due Mar 17 — 2 days late)
-```
-
-### MCP Resource: automatic reminder delivery
-
-logbook-mcp exposes a **Resource** (`logbook://reminders`) that MCP clients can load automatically when starting a session. This means your AI tells you about pending reminders **without you asking**.
-
-#### Resource compatibility
-
-| Client | Resources support | Reminders behavior |
-|--------|:-----------------:|-------------------|
-| **Claude Code** | ✅ Yes | Reminders shown automatically on session start |
-| **Claude Desktop** | ✅ Yes | Reminders shown automatically on session start |
-| **Cursor** | ❌ No | Ask *"any reminders?"* — works via `logbook_todo_list` |
-| **Windsurf** | ❌ No | Ask *"any reminders?"* — works via `logbook_todo_list` |
-| **VS Code + Copilot** | ⚠️ Partial | Depends on MCP extension used |
-| **Codex CLI** | ❌ No | Ask *"any reminders?"* — works via `logbook_todo_list` |
-| **Gemini CLI** | ❌ No | Ask *"any reminders?"* — works via `logbook_todo_list` |
-
-> **Important:** Even without Resource support, reminders always work. You just need to ask for them instead of getting them automatically. All 9 tools work identically across all MCP clients.
-
----
-
-## A Day With logbook-mcp
-
-Here's what a typical day looks like:
-
-### Morning — start your day
-
-```
-You: "What did I do yesterday?"
-
-Claude: Yesterday on my-api:
-  📝 [decision] Chose sliding window for rate limiting over fixed window
-  ☑ #8 Fixed token refresh bug
-  ☑ #12 Implemented email validation
-  📄 [resolved] FIXME in src/users/controller.ts (handle null case)
-
-You: "What's pending?"
-
-Claude: my-api — 4 pending:
-  📋 feature
-    ☐ #15 [HIGH] Dynamic permissions endpoint
-    📄 TODO: add OAuth — src/auth/service.ts:45
-  📋 chore
-    ☐ #21 Update dependencies
-  📋 reminder
-    ⏰ #25 Review PRs (recurring: every Tuesday)
-```
-
-### Working — capture as you go
-
-```
-You: "I decided to use Redis for session cache because
-      Memcached doesn't support key expiration callbacks"
-
-Claude: ✅ Note saved [decision] in my-api
-
-You: "TODO: add rate limit headers to API responses.
-      TODO: document the new permissions endpoint.
-      TODO: fix CORS for mobile app"
-
-Claude: ✅ 3 TODOs created:
-  ☐ #26 [feature] Add rate limit headers
-  ☐ #27 [chore] Document permissions endpoint
-  ☐ #28 [fix] Fix CORS for mobile app
-
-You: "Remind me Friday to deploy the permissions update"
-
-Claude: ✅ Reminder set for 2026-03-21 [reminder]
-```
-
-### End of day — wrap up
-
-```
-You: "Mark 15, 26, and 28 as done"
-
-Claude: ✅ 3 TODOs completed
-
-You: "What did I do today?"
-
-Claude: Today on my-api:
-  📝 [decision] Redis for session cache (expiration callbacks)
-  ☑ #15 Dynamic permissions endpoint
-  ☑ #26 Rate limit headers
-  ☑ #28 CORS fix for mobile
-  📄 [resolved] HACK in src/middleware/cors.ts (removed workaround)
-```
-
-### Weekly review — see the big picture
-
-```
-You: "Summary of this week across all projects"
-
-Claude:
-  my-api: 3 notes, 8 TODOs completed, 4 pending
-  my-frontend: 1 note, 3 TODOs completed, 2 pending
-  my-docs: 0 notes, 1 TODO completed, 0 pending
-
-You: "Search everything about auth across all projects"
+### Smart project detection
 
-Claude: 12 results:
-  [note] my-api — Decided JWT over sessions (Mar 12)
-  [note] my-api — Redis for session cache (Mar 19)
-  [todo] my-api — ☐ Add OAuth support
-  [todo] my-frontend — ☑ Auth redirect fix (completed Mar 15)
-  ...
-```
+logbook-mcp auto-detects which git project you're in via `git rev-parse`. No config needed — it scopes queries to the current project by default, with a `global` option to see everything.
 
 ---
 
@@ -464,10 +266,10 @@ Claude: 12 results:
 | **TODOs** | `logbook_todo_add` `logbook_todo_list` `logbook_todo_done` `logbook_todo_edit` `logbook_todo_rm` | 5 |
 | **Config** | `logbook_topics` | 1 |
 | **Resource** | `logbook://reminders` | — |
-| **Total** | | **9 tools + 1 resource** |
+| | | **9 tools + 1 resource** |
 
 <details>
-<summary><strong>logbook_log</strong> — Activity for a period</summary>
+<summary><code>logbook_log</code> — Activity for a period</summary>
 
 Shows notes, completed TODOs, and resolved code TODOs for a time range.
 
@@ -482,7 +284,7 @@ Shows notes, completed TODOs, and resolved code TODOs for a time range.
 </details>
 
 <details>
-<summary><strong>logbook_note</strong> — Add a note</summary>
+<summary><code>logbook_note</code> — Add a note</summary>
 
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
@@ -491,7 +293,7 @@ Shows notes, completed TODOs, and resolved code TODOs for a time range.
 </details>
 
 <details>
-<summary><strong>logbook_todo_add</strong> — Create TODOs</summary>
+<summary><code>logbook_todo_add</code> — Create TODOs</summary>
 
 | Param | Type | Description |
 |-------|------|-------------|
@@ -504,7 +306,7 @@ Shows notes, completed TODOs, and resolved code TODOs for a time range.
 </details>
 
 <details>
-<summary><strong>logbook_todo_list</strong> — List TODOs</summary>
+<summary><code>logbook_todo_list</code> — List TODOs</summary>
 
 | Param | Type | Default | Description |
 |-------|------|---------|-------------|
@@ -517,7 +319,7 @@ Shows notes, completed TODOs, and resolved code TODOs for a time range.
 </details>
 
 <details>
-<summary><strong>logbook_todo_done</strong> — Mark as done/undo</summary>
+<summary><code>logbook_todo_done</code> — Mark as done / undo</summary>
 
 | Param | Type | Description |
 |-------|------|-------------|
@@ -528,7 +330,7 @@ For recurring reminders, "done" means acknowledged for today. It will reappear o
 </details>
 
 <details>
-<summary><strong>logbook_todo_edit</strong> — Edit a TODO</summary>
+<summary><code>logbook_todo_edit</code> — Edit a TODO</summary>
 
 | Param | Type | Description |
 |-------|------|-------------|
@@ -539,7 +341,7 @@ For recurring reminders, "done" means acknowledged for today. It will reappear o
 </details>
 
 <details>
-<summary><strong>logbook_todo_rm</strong> — Delete TODOs</summary>
+<summary><code>logbook_todo_rm</code> — Delete TODOs</summary>
 
 | Param | Type | Description |
 |-------|------|-------------|
@@ -549,7 +351,7 @@ Use this to stop recurring reminders permanently.
 </details>
 
 <details>
-<summary><strong>logbook_search</strong> — Full-text search</summary>
+<summary><code>logbook_search</code> — Full-text search</summary>
 
 | Param | Type | Default | Description |
 |-------|------|---------|-------------|
@@ -561,7 +363,7 @@ Use this to stop recurring reminders permanently.
 </details>
 
 <details>
-<summary><strong>logbook_topics</strong> — Manage topics</summary>
+<summary><code>logbook_topics</code> — Manage topics</summary>
 
 | Param | Type | Default | Description |
 |-------|------|---------|-------------|
@@ -574,18 +376,21 @@ Use this to stop recurring reminders permanently.
 
 ## Storage
 
-All data lives in a single SQLite database:
+All data lives in a single SQLite database at `~/.logbook/logbook.db`.
 
 ```
 ~/.logbook/
-└── logbook.db          # All projects, notes, TODOs, reminders in one file
+└── logbook.db
 ```
 
 - **WAL mode** for concurrent reads
 - **FTS5** virtual tables for instant full-text search
 - **Triggers** keep search indexes in sync automatically
 - **Foreign keys** with `ON DELETE SET NULL` — delete a project, notes remain
-- **Code TODO snapshots** — tracks which code TODOs existed, detects when they're resolved
+- **Code TODO snapshots** — tracks which code TODOs existed, detects when they disappear
+
+> [!NOTE]
+> The database is created automatically on first use. No setup required.
 
 ---
 
@@ -609,24 +414,8 @@ src/
 └── tools/                # 9 MCP tools (one file each)
 ```
 
-**Stack:** TypeScript &middot; MCP SDK 1.27 &middot; better-sqlite3 &middot; Zod &middot; Vitest &middot; tsup
-
----
-
-## Contributing
-
-```bash
-git clone https://github.com/cocaxcode/logbook-mcp.git
-cd logbook-mcp
-npm install
-npm test              # 60 tests
-npm run build         # Build with tsup
-npm run typecheck     # TypeScript check
-npm run inspector     # Test with MCP Inspector
-```
+**Stack:** TypeScript &middot; MCP SDK &middot; better-sqlite3 &middot; Zod &middot; tsup
 
 ---
 
-## License
-
-MIT &copy; [cocaxcode](https://github.com/cocaxcode)
+[MIT](./LICENSE) &middot; Built by [cocaxcode](https://github.com/cocaxcode)

package/dist/{cli-LHRPHO2C.js → cli-FULNDCWB.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-var VERSION = true ? "0.4.9" : "0.0.0";
+var VERSION = true ? "0.4.10" : "0.0.0";
 async function runCli(argv) {
   if (argv.includes("--version") || argv.includes("-v")) {
     console.log(`logbook-mcp v${VERSION}`);

package/dist/index.js

@@ -6,13 +6,13 @@ async function main() {
   const hasMcpFlag = argv.includes("--mcp");
   if (hasMcpFlag) {
     const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
-    const { createServer } = await import("./server-SU6V6LNU.js");
+    const { createServer } = await import("./server-WQ6ILBUZ.js");
     const server = createServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("logbook-mcp server running on stdio");
   } else {
-    const { runCli } = await import("./cli-LHRPHO2C.js");
+    const { runCli } = await import("./cli-FULNDCWB.js");
     await runCli(argv);
   }
 }

package/dist/{server-SU6V6LNU.js → server-WQ6ILBUZ.js}

@@ -1139,7 +1139,7 @@ function registerRemindersResource(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.4.9" : "0.0.0";
+var VERSION = true ? "0.4.10" : "0.0.0";
 function createServer() {
   const server = new McpServer({
     name: "logbook-mcp",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocaxcode/logbook-mcp",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Developer logbook MCP server. Notes, TODOs, reminders, code TODOs with full-text search. Zero config, auto-detects projects, SQLite-powered. Works with Claude, Cursor, Windsurf, Copilot, Gemini, Codex.",
   "type": "module",
   "bin": {