@cookielab.io/klovi

Browse and present AI coding session history. Supports Claude Code, Codex CLI, Cursor, and OpenCode.

Quick Start

bunx @cookielab.io/klovi@latest

Klovi starts a local server on http://127.0.0.1:3583 and opens your browser. All data stays on your machine. Sessions are read directly from each tool's local storage.

Compatibility run:

npx @cookielab.io/klovi@latest

CLI Options

klovi [options]

Options:
  --port NUMBER     Override the default port (default: 3583)
  --no-browser      Start the server without opening a browser

Environment Variables

| Variable | Default | Description | |---|---|---| | KLOVI_PORT | 3583 | Server port | | KLOVI_HOST | 127.0.0.1 | Bind address (localhost-only by default) | | KLOVI_STATIC_DIR | (auto) | Override the static assets directory | | KLOVI_SETTINGS_PATH | ~/.klovi/settings.json | Override the settings file used by the CLI |

Programmatic API

import { startKloviServer } from "@cookielab.io/klovi/server";

const server = await startKloviServer({
  host: "127.0.0.1",
  port: 3583,
});

console.log(`Klovi listening on ${server.url}`);

// Later:
server.stop();

startKloviServer(options?)

Starts the Klovi backend server. Returns { url, stop() }.

| Option | Type | Default | Description | |---|---|---|---| | host | string | "127.0.0.1" | Bind address | | port | number | 0 (auto) | Server port | | version | string | "dev" | Version string | | commit | string | "" | Commit hash | | settingsPath | string | ~/.klovi/settings.json | Settings file path | | runtime | "auto" \| "bun" \| "node" | "auto" | Runtime selection |

Supported Tools

• Claude Code — reads from ~/.claude/projects/
• Codex CLI — reads from ~/.codex/sessions/
• Cursor — reads from ~/.cursor/ plus Cursor's platform-specific app-support SQLite state
• OpenCode — reads from ~/.local/share/opencode/opencode.db

Settings

Klovi stores settings in ~/.klovi/settings.json by default. The settings file tracks:

• enabled/disabled state for each built-in plugin
• optional custom data directory overrides per plugin
• general UI settings such as the security warning preference

In browser-served mode there is no native directory picker, so custom plugin paths are edited manually.

License

MIT