chat-logbook 0.7.1 → 0.8.0

package/api/dist/index.js

@@ -4758,12 +4758,12 @@ function mapRelationalRow(tablesConfig, tableConfig, row, buildQueryResultSelect
 var schema_exports = {};
 __export(schema_exports, {
   archiveMeta: () => archiveMeta,
+  chatScanState: () => chatScanState,
+  chats: () => chats,
   ingestionEvents: () => ingestionEvents,
   messages: () => messages,
   rawMessages: () => rawMessages,
-  schemaVersion: () => schemaVersion,
-  sessionScanState: () => sessionScanState,
-  sessions: () => sessions
+  schemaVersion: () => schemaVersion
 });
 
 // ../node_modules/.pnpm/drizzle-orm@0.45.2_@types+better-sqlite3@7.6.13_better-sqlite3@12.9.0/node_modules/drizzle-orm/sqlite-core/foreign-keys.js
@@ -8179,26 +8179,24 @@ var schemaVersion = sqliteTable("schema_version", {
   version: integer("version").primaryKey(),
   appliedAt: integer("applied_at", { mode: "timestamp_ms" }).notNull()
 });
-var sessions = sqliteTable(
-  "sessions",
+var chats = sqliteTable(
+  "chats",
   {
     id: text("id").primaryKey(),
-    shortCode: text("short_code").notNull().unique(),
+    chatId: text("chat_id").notNull().unique(),
     agent: text("agent").notNull(),
-    sourceSessionId: text("source_session_id").notNull(),
+    sourceId: text("source_id").notNull(),
     firstSeenAt: integer("first_seen_at", { mode: "timestamp_ms" }).notNull(),
     project: text("project")
   },
-  (t) => [
-    uniqueIndex("sessions_agent_source_idx").on(t.agent, t.sourceSessionId)
-  ]
+  (t) => [uniqueIndex("chats_agent_source_idx").on(t.agent, t.sourceId)]
 );
 var rawMessages = sqliteTable(
   "raw_messages",
   {
     id: integer("id").primaryKey({ autoIncrement: true }),
     agent: text("agent").notNull(),
-    sessionId: text("session_id").notNull(),
+    sourceId: text("source_id").notNull(),
     sourcePath: text("source_path").notNull(),
     sourceLocator: text("source_locator").notNull(),
     rawPayload: text("raw_payload").notNull(),
@@ -8206,11 +8204,7 @@ var rawMessages = sqliteTable(
     ingestedAt: integer("ingested_at", { mode: "timestamp_ms" }).notNull()
   },
   (t) => [
-    uniqueIndex("raw_messages_idem_idx").on(
-      t.agent,
-      t.sessionId,
-      t.payloadHash
-    )
+    uniqueIndex("raw_messages_idem_idx").on(t.agent, t.sourceId, t.payloadHash)
   ]
 );
 var messages = sqliteTable(
@@ -8218,7 +8212,7 @@ var messages = sqliteTable(
   {
     id: integer("id").primaryKey({ autoIncrement: true }),
     agent: text("agent").notNull(),
-    sessionId: text("session_id").notNull(),
+    sourceId: text("source_id").notNull(),
     messageId: text("message_id").notNull(),
     role: text("role").notNull(),
     ts: integer("ts", { mode: "timestamp_ms" }).notNull(),
@@ -8227,15 +8221,15 @@ var messages = sqliteTable(
     rawId: integer("raw_id").notNull().references(() => rawMessages.id)
   },
   (t) => [
-    uniqueIndex("messages_canonical_idx").on(t.agent, t.sessionId, t.messageId)
+    uniqueIndex("messages_canonical_idx").on(t.agent, t.sourceId, t.messageId)
   ]
 );
-var sessionScanState = sqliteTable(
+var chatScanState = sqliteTable(
   "session_scan_state",
   {
     id: integer("id").primaryKey({ autoIncrement: true }),
     agent: text("agent").notNull(),
-    sessionId: text("session_id").notNull(),
+    sourceId: text("source_id").notNull(),
     sourcePath: text("source_path").notNull(),
     lastMtimeMs: integer("last_mtime_ms").notNull(),
     lastSizeBytes: integer("last_size_bytes").notNull(),
@@ -8243,12 +8237,12 @@ var sessionScanState = sqliteTable(
       mode: "timestamp_ms"
     }).notNull()
   },
-  (t) => [uniqueIndex("session_scan_state_idx").on(t.agent, t.sessionId)]
+  (t) => [uniqueIndex("session_scan_state_idx").on(t.agent, t.sourceId)]
 );
 var ingestionEvents = sqliteTable("ingestion_events", {
   id: integer("id").primaryKey({ autoIncrement: true }),
   agent: text("agent").notNull(),
-  sessionId: text("session_id").notNull(),
+  sourceId: text("source_id").notNull(),
   sourcePath: text("source_path").notNull(),
   eventType: text("event_type").notNull(),
   detail: text("detail", { mode: "json" }).notNull(),
@@ -8256,7 +8250,7 @@ var ingestionEvents = sqliteTable("ingestion_events", {
 });
 
 // src/visibility.ts
-function loadSessionVisibility(metadata2, opts) {
+function loadChatVisibility(metadata2, opts) {
   const trashed = new Set(metadata2.listDeletedIds());
   const showTrashed = opts.includeTrashed === true;
   return {
@@ -8279,59 +8273,59 @@ function toApiBlock(block) {
 var CLAUDE_CODE_AGENT = "claude-code";
 function createApp({ archive: archive2, metadata: metadata2, webDistDir: webDistDir2 }) {
   const app2 = new Hono2();
-  function findArchiveSessionBySourceId(sourceSessionId) {
-    return archive2.db.select().from(sessions).where(eq(sessions.sourceSessionId, sourceSessionId)).get();
+  function findArchiveChatBySourceId(sourceId) {
+    return archive2.db.select().from(chats).where(eq(chats.sourceId, sourceId)).get();
   }
-  app2.get("/api/sessions", (c) => {
-    const visibility = loadSessionVisibility(metadata2, {
+  app2.get("/api/chats", (c) => {
+    const visibility = loadChatVisibility(metadata2, {
       includeTrashed: c.req.query("includeTrashed") === "true"
     });
-    const rows = archive2.db.select().from(sessions).all();
-    const sessions2 = [];
+    const rows = archive2.db.select().from(chats).all();
+    const chats2 = [];
     for (const row of rows) {
       if (!visibility.isVisible(row.id)) continue;
       const isDeleted = visibility.isTrashed(row.id);
       const lastMessage = archive2.db.select({ ts: messages.ts }).from(messages).where(
         and(
           eq(messages.agent, CLAUDE_CODE_AGENT),
-          eq(messages.sessionId, row.sourceSessionId)
+          eq(messages.sourceId, row.sourceId)
         )
       ).orderBy(desc(messages.ts)).limit(1).get();
-      const session = {
-        id: row.sourceSessionId,
+      const chat = {
+        id: row.sourceId,
         title: deriveTitle(archive2, metadata2, row),
         project: row.project ?? "",
         createdAt: row.firstSeenAt.getTime(),
         updatedAt: lastMessage ? lastMessage.ts.getTime() : row.firstSeenAt.getTime()
       };
-      if (isDeleted) session.isDeleted = true;
-      sessions2.push(session);
+      if (isDeleted) chat.isDeleted = true;
+      chats2.push(chat);
     }
-    return c.json({ sessions: sessions2 });
+    return c.json({ chats: chats2 });
   });
-  app2.delete("/api/sessions/:id", (c) => {
-    const sessionId = c.req.param("id");
-    const row = findArchiveSessionBySourceId(sessionId);
+  app2.delete("/api/chats/:id", (c) => {
+    const id = c.req.param("id");
+    const row = findArchiveChatBySourceId(id);
     if (!row) {
-      return c.json({ error: "Session not found" }, 404);
+      return c.json({ error: "Chat not found" }, 404);
     }
     metadata2.softDelete(row.id);
     return c.body(null, 204);
   });
-  app2.post("/api/sessions/:id/restore", (c) => {
-    const sessionId = c.req.param("id");
-    const row = findArchiveSessionBySourceId(sessionId);
+  app2.post("/api/chats/:id/restore", (c) => {
+    const id = c.req.param("id");
+    const row = findArchiveChatBySourceId(id);
     if (!row) {
-      return c.json({ error: "Session not found" }, 404);
+      return c.json({ error: "Chat not found" }, 404);
     }
     metadata2.restore(row.id);
     return c.body(null, 204);
   });
-  app2.patch("/api/sessions/:id/title", async (c) => {
-    const sessionId = c.req.param("id");
-    const row = findArchiveSessionBySourceId(sessionId);
+  app2.patch("/api/chats/:id/title", async (c) => {
+    const id = c.req.param("id");
+    const row = findArchiveChatBySourceId(id);
     if (!row) {
-      return c.json({ error: "Session not found" }, 404);
+      return c.json({ error: "Chat not found" }, 404);
     }
     let body;
     try {
@@ -8350,22 +8344,22 @@ function createApp({ archive: archive2, metadata: metadata2, webDistDir: webDist
     metadata2.setCustomTitle(row.id, trimmed.length > 0 ? trimmed : null);
     return c.body(null, 204);
   });
-  app2.get("/api/sessions/:id", (c) => {
-    const sessionId = c.req.param("id");
-    const row = findArchiveSessionBySourceId(sessionId);
+  app2.get("/api/chats/:id", (c) => {
+    const id = c.req.param("id");
+    const row = findArchiveChatBySourceId(id);
     if (!row) {
-      return c.json({ error: "Session not found" }, 404);
+      return c.json({ error: "Chat not found" }, 404);
     }
-    const visibility = loadSessionVisibility(metadata2, {
+    const visibility = loadChatVisibility(metadata2, {
       includeTrashed: c.req.query("includeTrashed") === "true"
     });
     if (!visibility.isVisible(row.id)) {
-      return c.json({ error: "Session not found" }, 404);
+      return c.json({ error: "Chat not found" }, 404);
     }
     const rows = archive2.db.select().from(messages).where(
       and(
         eq(messages.agent, CLAUDE_CODE_AGENT),
-        eq(messages.sessionId, sessionId)
+        eq(messages.sourceId, id)
       )
     ).orderBy(asc(messages.ts)).all();
     const messages2 = rows.map((m) => ({
@@ -8381,7 +8375,7 @@ function createApp({ archive: archive2, metadata: metadata2, webDistDir: webDist
     const firstUser = archive3.db.select({ text: messages.text }).from(messages).where(
       and(
         eq(messages.agent, CLAUDE_CODE_AGENT),
-        eq(messages.sessionId, row.sourceSessionId),
+        eq(messages.sourceId, row.sourceId),
         eq(messages.role, "user")
       )
     ).orderBy(asc(messages.ts)).limit(1).get();
@@ -8601,18 +8595,18 @@ function migrate(db, config) {
   db.dialect.migrate(migrations, db.session, config);
 }
 
-// src/archive/short-code.ts
+// src/archive/chat-id.ts
 import crypto4 from "crypto";
 var CROCKFORD_ALPHABET = "0123456789abcdefghjkmnpqrstvwxyz";
-var SHORT_CODE_LENGTH = 6;
+var CHAT_ID_LENGTH = 6;
 var MAX_RETRIES = 5;
-function generateShortCode({
+function generateChatId({
   isTaken,
   randomIndex = () => crypto4.randomInt(CROCKFORD_ALPHABET.length)
 }) {
   for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
     let code = "";
-    for (let i = 0; i < SHORT_CODE_LENGTH; i++) {
+    for (let i = 0; i < CHAT_ID_LENGTH; i++) {
       code += CROCKFORD_ALPHABET[randomIndex()];
     }
     if (!isTaken(code)) {
@@ -8620,7 +8614,7 @@ function generateShortCode({
     }
   }
   throw new Error(
-    `Failed to generate unique short_code after ${MAX_RETRIES + 1} attempts`
+    `Failed to generate unique chat_id after ${MAX_RETRIES + 1} attempts`
   );
 }
 
@@ -8668,9 +8662,9 @@ function createArchiveRepository({
     getAppliedMigrations() {
       return db.select().from(schemaVersion).all().map((r) => ({ version: r.version, appliedAt: r.appliedAt }));
     },
-    generateShortCode() {
-      return generateShortCode({
-        isTaken: (candidate) => db.select({ id: sessions.id }).from(sessions).where(eq(sessions.shortCode, candidate)).get() !== void 0
+    generateChatId() {
+      return generateChatId({
+        isTaken: (candidate) => db.select({ id: chats.id }).from(chats).where(eq(chats.chatId, candidate)).get() !== void 0
       });
     },
     close() {
@@ -8686,7 +8680,7 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 import Database2 from "better-sqlite3";
 
 // src/metadata/schema.ts
-var sessionsMeta = sqliteTable("sessions_meta", {
+var chatsMeta = sqliteTable("chats_meta", {
   id: text("id").primaryKey(),
   isDeleted: integer("is_deleted", { mode: "boolean" }).notNull().default(false),
   customTitle: text("custom_title"),
@@ -8711,71 +8705,71 @@ var CLAUDE_CODE_AGENT2 = "claude-code";
 function createMetadataRepository({
   dataDir: dataDir2,
   lookupInternalId,
-  ensureSession: ensureSession2
+  ensureChat: ensureChat2
 }) {
   fs3.mkdirSync(dataDir2, { recursive: true });
   const sqlite = new Database2(path2.join(dataDir2, "data.db"));
   const db = drizzle(sqlite);
   migrate(db, { migrationsFolder: resolveMigrationsFolder2() });
   if (lookupInternalId) {
-    rekeyLegacyRows(sqlite, db, lookupInternalId, ensureSession2);
+    rekeyLegacyRows(sqlite, db, lookupInternalId, ensureChat2);
   }
   return {
     softDelete(internalId) {
       const now = /* @__PURE__ */ new Date();
-      db.insert(sessionsMeta).values({
+      db.insert(chatsMeta).values({
         id: internalId,
         isDeleted: true,
         createdAt: now,
         updatedAt: now
       }).onConflictDoUpdate({
-        target: sessionsMeta.id,
+        target: chatsMeta.id,
         set: { isDeleted: true, updatedAt: now }
       }).run();
     },
     restore(internalId) {
       const now = /* @__PURE__ */ new Date();
-      db.update(sessionsMeta).set({ isDeleted: false, updatedAt: now }).where(eq(sessionsMeta.id, internalId)).run();
+      db.update(chatsMeta).set({ isDeleted: false, updatedAt: now }).where(eq(chatsMeta.id, internalId)).run();
     },
     isDeleted(internalId) {
-      const row = db.select({ isDeleted: sessionsMeta.isDeleted }).from(sessionsMeta).where(eq(sessionsMeta.id, internalId)).get();
+      const row = db.select({ isDeleted: chatsMeta.isDeleted }).from(chatsMeta).where(eq(chatsMeta.id, internalId)).get();
       return row?.isDeleted ?? false;
     },
     listDeletedIds() {
-      const rows = db.select({ id: sessionsMeta.id }).from(sessionsMeta).where(eq(sessionsMeta.isDeleted, true)).all();
+      const rows = db.select({ id: chatsMeta.id }).from(chatsMeta).where(eq(chatsMeta.isDeleted, true)).all();
       return rows.map((r) => r.id);
     },
     getCustomTitle(internalId) {
-      const row = db.select({ customTitle: sessionsMeta.customTitle }).from(sessionsMeta).where(eq(sessionsMeta.id, internalId)).get();
+      const row = db.select({ customTitle: chatsMeta.customTitle }).from(chatsMeta).where(eq(chatsMeta.id, internalId)).get();
       return row?.customTitle ?? null;
     },
     setCustomTitle(internalId, title) {
       const now = /* @__PURE__ */ new Date();
-      db.insert(sessionsMeta).values({
+      db.insert(chatsMeta).values({
         id: internalId,
         customTitle: title,
         createdAt: now,
         updatedAt: now
       }).onConflictDoUpdate({
-        target: sessionsMeta.id,
+        target: chatsMeta.id,
         set: { customTitle: title, updatedAt: now }
       }).run();
     }
   };
 }
 var REKEY_USER_VERSION = 4;
-function rekeyLegacyRows(sqlite, db, lookupInternalId, ensureSession2) {
+function rekeyLegacyRows(sqlite, db, lookupInternalId, ensureChat2) {
   const current = sqlite.pragma("user_version", { simple: true });
   if (current >= REKEY_USER_VERSION) return;
-  const rows = db.select({ id: sessionsMeta.id }).from(sessionsMeta).all();
+  const rows = db.select({ id: chatsMeta.id }).from(chatsMeta).all();
   for (const row of rows) {
     let target = lookupInternalId(CLAUDE_CODE_AGENT2, row.id);
     if (target === null) {
-      if (!ensureSession2) continue;
-      target = ensureSession2(CLAUDE_CODE_AGENT2, row.id);
+      if (!ensureChat2) continue;
+      target = ensureChat2(CLAUDE_CODE_AGENT2, row.id);
     }
     if (target === row.id) continue;
-    db.update(sessionsMeta).set({ id: target, updatedAt: /* @__PURE__ */ new Date() }).where(eq(sessionsMeta.id, row.id)).run();
+    db.update(chatsMeta).set({ id: target, updatedAt: /* @__PURE__ */ new Date() }).where(eq(chatsMeta.id, row.id)).run();
   }
   sqlite.pragma(`user_version = ${REKEY_USER_VERSION}`);
 }
@@ -8795,13 +8789,13 @@ async function runIngestion(opts) {
     for await (const ref of plugin.discover(opts.env)) {
       result.scanned += 1;
       const stat4 = safeStat(ref.sourcePath);
-      const prior = opts.archive.db.select().from(sessionScanState).where(
+      const prior = opts.archive.db.select().from(chatScanState).where(
         and(
-          eq(sessionScanState.agent, plugin.id),
-          eq(sessionScanState.sessionId, ref.sessionId)
+          eq(chatScanState.agent, plugin.id),
+          eq(chatScanState.sourceId, ref.sourceId)
         )
       ).get();
-      ensureSession(opts.archive, plugin.id, ref.sessionId, now(), ref.project);
+      ensureChat(opts.archive, plugin.id, ref.sourceId, now(), ref.project);
       if (stat4 && prior && prior.lastMtimeMs === stat4.mtimeMs && prior.lastSizeBytes === stat4.size) {
         result.skippedByMtime += 1;
         continue;
@@ -8812,7 +8806,7 @@ async function runIngestion(opts) {
         const existing = opts.archive.db.select({ id: rawMessages.id }).from(rawMessages).where(
           and(
             eq(rawMessages.agent, plugin.id),
-            eq(rawMessages.sessionId, ref.sessionId),
+            eq(rawMessages.sourceId, ref.sourceId),
             eq(rawMessages.payloadHash, payloadHash)
           )
         ).get();
@@ -8822,7 +8816,7 @@ async function runIngestion(opts) {
         } else {
           const inserted = opts.archive.db.insert(rawMessages).values({
             agent: plugin.id,
-            sessionId: ref.sessionId,
+            sourceId: ref.sourceId,
             sourcePath: raw2.sourcePath,
             sourceLocator: raw2.sourceLocator,
             rawPayload: payloadJson,
@@ -8837,7 +8831,7 @@ async function runIngestion(opts) {
         const upserted = upsertCanonical(
           opts.archive,
           plugin.id,
-          ref.sessionId,
+          ref.sourceId,
           canonical,
           rawId
         );
@@ -8847,7 +8841,7 @@ async function runIngestion(opts) {
         recordScanState(
           opts.archive,
           plugin.id,
-          ref.sessionId,
+          ref.sourceId,
           ref.sourcePath,
           stat4,
           now()
@@ -8864,24 +8858,21 @@ function safeStat(p) {
     return null;
   }
 }
-function recordScanState(archive2, agent, sessionId, sourcePath, stat4, scannedAt) {
-  const existing = archive2.db.select({ id: sessionScanState.id }).from(sessionScanState).where(
-    and(
-      eq(sessionScanState.agent, agent),
-      eq(sessionScanState.sessionId, sessionId)
-    )
+function recordScanState(archive2, agent, sourceId, sourcePath, stat4, scannedAt) {
+  const existing = archive2.db.select({ id: chatScanState.id }).from(chatScanState).where(
+    and(eq(chatScanState.agent, agent), eq(chatScanState.sourceId, sourceId))
   ).get();
   if (existing) {
-    archive2.db.update(sessionScanState).set({
+    archive2.db.update(chatScanState).set({
       sourcePath,
       lastMtimeMs: stat4.mtimeMs,
       lastSizeBytes: stat4.size,
       lastScannedAt: scannedAt
-    }).where(eq(sessionScanState.id, existing.id)).run();
+    }).where(eq(chatScanState.id, existing.id)).run();
   } else {
-    archive2.db.insert(sessionScanState).values({
+    archive2.db.insert(chatScanState).values({
       agent,
-      sessionId,
+      sourceId,
       sourcePath,
       lastMtimeMs: stat4.mtimeMs,
       lastSizeBytes: stat4.size,
@@ -8889,36 +8880,31 @@ function recordScanState(archive2, agent, sessionId, sourcePath, stat4, scannedA
     }).run();
   }
 }
-function ensureSession(archive2, agent, sourceSessionId, firstSeenAt, project) {
-  const existing = archive2.db.select().from(sessions).where(
-    and(
-      eq(sessions.agent, agent),
-      eq(sessions.sourceSessionId, sourceSessionId)
-    )
-  ).get();
+function ensureChat(archive2, agent, sourceId, firstSeenAt, project) {
+  const existing = archive2.db.select().from(chats).where(and(eq(chats.agent, agent), eq(chats.sourceId, sourceId))).get();
   if (existing) {
     if (project && existing.project !== project) {
-      archive2.db.update(sessions).set({ project }).where(eq(sessions.id, existing.id)).run();
+      archive2.db.update(chats).set({ project }).where(eq(chats.id, existing.id)).run();
     }
     return existing.id;
   }
   const id = crypto6.randomUUID();
-  const shortCode = archive2.generateShortCode();
-  archive2.db.insert(sessions).values({
+  const chatId = archive2.generateChatId();
+  archive2.db.insert(chats).values({
     id,
-    shortCode,
+    chatId,
     agent,
-    sourceSessionId,
+    sourceId,
     firstSeenAt,
     project: project ?? null
   }).run();
   return id;
 }
-function upsertCanonical(archive2, agent, sessionId, msg, rawId) {
+function upsertCanonical(archive2, agent, sourceId, msg, rawId) {
   const existing = archive2.db.select().from(messages).where(
     and(
       eq(messages.agent, agent),
-      eq(messages.sessionId, sessionId),
+      eq(messages.sourceId, sourceId),
       eq(messages.messageId, msg.messageId)
     )
   ).get();
@@ -8926,7 +8912,7 @@ function upsertCanonical(archive2, agent, sessionId, msg, rawId) {
   if (!existing) {
     archive2.db.insert(messages).values({
       agent,
-      sessionId,
+      sourceId,
       messageId: msg.messageId,
       role: msg.role,
       ts,
@@ -10741,7 +10727,7 @@ function startWatcher(opts) {
     try {
       opts.archive.db.insert(ingestionEvents).values({
         agent: binding.plugin.id,
-        sessionId: binding.ref.sessionId,
+        sourceId: binding.ref.sourceId,
         sourcePath: removedPath,
         eventType: "unlink_observed",
         detail: { path: removedPath },
@@ -10794,10 +10780,10 @@ var ClaudeCodePlugin = class {
       for (const file of files) {
         if (!file.isFile() || !file.name.endsWith(".jsonl")) continue;
         const sourcePath = path3.join(projectPath, file.name);
-        const sessionId = file.name.replace(/\.jsonl$/, "");
+        const sourceId = file.name.replace(/\.jsonl$/, "");
         const cwd = await readCwdFromJsonl(sourcePath);
         yield {
-          sessionId,
+          sourceId,
           sourcePath,
           watchPaths: [sourcePath],
           project: cwd ? path3.basename(cwd) : void 0
@@ -10814,7 +10800,7 @@ var ClaudeCodePlugin = class {
       lineNo += 1;
       if (!line) continue;
       yield {
-        sessionId: ref.sessionId,
+        sourceId: ref.sourceId,
         sourcePath: ref.sourcePath,
         sourceLocator: `L${lineNo}`,
         payload: JSON.parse(line)
@@ -10917,6 +10903,7 @@ function parseCliArgs(argv, env = {}) {
   if (argv.includes("--help") || argv.includes("-h")) {
     return { kind: "help" };
   }
+  const open2 = !env.CHAT_LOGBOOK_NO_OPEN;
   const portIdx = argv.findIndex((a) => a === "--port" || a === "-p");
   if (portIdx !== -1) {
     const raw2 = argv[portIdx + 1];
@@ -10939,12 +10926,12 @@ function parseCliArgs(argv, env = {}) {
         message: `Invalid port "${raw2}": must be between 1 and 65535`
       };
     }
-    return { kind: "run", port: port2 };
+    return { kind: "run", port: port2, open: open2 };
   }
   if (env.PORT) {
-    return { kind: "run", port: Number(env.PORT) };
+    return { kind: "run", port: Number(env.PORT), open: open2 };
   }
-  return { kind: "run", port: DEFAULT_PORT };
+  return { kind: "run", port: DEFAULT_PORT, open: open2 };
 }
 
 // src/cli/help.ts
@@ -11011,7 +10998,7 @@ function openBrowser(url) {
 var server = serve({ fetch: app.fetch, port }, (info) => {
   const url = `http://localhost:${info.port}`;
   console.log(`chat-logbook is running at \x1B[36m${url}\x1B[0m`);
-  openBrowser(url);
+  if (action.open) openBrowser(url);
 });
 server.on("error", (err) => {
   if (err.code === "EADDRINUSE") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat-logbook",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "A local-first conversation manager for Claude Code",
   "license": "AGPL-3.0-only",
   "type": "module",