Klovi

Klovi lets you browse, search, and present AI coding session history from Claude Code, Codex CLI, and OpenCode. It ships in two distribution modes that share the same backend, plugin, and UI packages:

• Desktop app: native Electrobun shell with menus, updater integration, and directory picker support
• Browser-served package: bunx @cookielab.io/klovi, serving the shared UI in your browser on 127.0.0.1

Quick Start

Desktop app

macOS (Apple Silicon) via Homebrew:

brew install --cask cookielab/tap/klovi

Or download the latest release for your platform from the Releases page.

Browser-served npm package

bunx @cookielab.io/klovi

Klovi starts a localhost-only server on http://127.0.0.1:3583, opens your browser by default, and reads session data directly from the local storage used by each supported tool.

Compatibility run:

npx @cookielab.io/klovi

For programmatic embedding:

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

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

Advanced CLI overrides:

• KLOVI_HOST
• KLOVI_PORT
• KLOVI_STATIC_DIR
• KLOVI_SETTINGS_PATH

CLI flags:

• --port <number>
• --no-browser

Development

bun install

Use the root workspace scripts that match the runtime you want to exercise:

• bun run dev:desktop starts the Electrobun desktop app
• bun run dev:bun starts the browser-served package through Bun
• bun run dev:node starts the browser/npm variant through Node/tsx

Linux note:

• Klovi defaults to CEF on Linux. If a Wayland/X11 setup is unstable, launch with KLOVI_LINUX_RENDERER=native to use the native renderer fallback.

Workspace Layout

Apps

• apps/package - npm/browser distribution source for @cookielab.io/klovi
• apps/desktop - Electrobun desktop shell and release packaging

Packages

• packages/server - backend services, RPC/HTTP server bootstrap, Effect runtime composition
• packages/ui - shared React app shell and transport-neutral UI bootstrap
• packages/plugin-core - plugin contracts and registry primitives
• packages/plugin-claude-code - Claude Code discovery, parsing, frontend integration
• packages/plugin-codex - Codex discovery, parsing, frontend integration
• packages/plugin-opencode - OpenCode discovery, parsing, frontend integration
• packages/ui-components - reusable Klovi-specific UI feature components
• packages/design-system - design tokens, primitives, and global styles

Features

• Unified browsing for Claude Code, Codex CLI, and OpenCode sessions
• Project merging across tools that share the same working directory
• Search across discovered sessions
• Session presentation mode for demos and talks
• Per-plugin enable/disable and data-directory settings
• Security warning onboarding for local session access
• Desktop-native capabilities in the Electrobun app, including update checks
• Browser-served mode through a single npm package
• Plugin-specific tool summaries, input formatting, and resume commands

Scripts

Script	Description
bun run dev:desktop	Start the Electrobun desktop app in development
bun run dev:bun	Start the npm/browser variant with Bun
bun run dev:node	Start the npm/browser variant with Node/tsx
bun run build	Build the desktop app
bun run build:web	Build the shared UI bundle
bun run build:package	Build the npm/browser package source artifact
bun run stage:npm	Stage the sanitized npm publish artifact
bun run verify:packed-artifact	Verify the staged npm artifact under Node and Bun
bun test	Run the full Bun test suite
bun run test:node-smoke	Run the Node plugin runtime smoke test
bun run typecheck	Run TypeScript type checking
bun run check	Run Biome lint/format checks
bun run storybook	Start the design-system Storybook

Documentation

• docs/architecture.md - runtime/package architecture
• docs/components.md - UI layers and wrapper composition
• docs/testing.md - test setup and verification workflow
• CONTENT_TYPES.md - JSONL content type catalog

Contributing

See CONTRIBUTING.md for setup and workflow details.

Trademark Notice

"Claude" and "Claude Code" are trademarks of Anthropic, PBC. "OpenAI", "ChatGPT", and "Codex" are trademarks of OpenAI, Inc. "OpenCode" is a trademark of its respective owner. This project is not affiliated with, endorsed by, or sponsored by Anthropic, OpenAI, or any other AI tool vendor.