https://github.com/cookielab/klovi
Desktop viewer for AI coding sessions — Claude Code, Codex, and OpenCode
https://github.com/cookielab/klovi
ai-coding claude-code codex opencode
Last synced: about 2 months ago
JSON representation
Desktop viewer for AI coding sessions — Claude Code, Codex, and OpenCode
- Host: GitHub
- URL: https://github.com/cookielab/klovi
- Owner: cookielab
- License: mit
- Created: 2026-02-07T17:10:17.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-12T23:23:17.000Z (2 months ago)
- Last Synced: 2026-04-13T01:17:58.141Z (2 months ago)
- Topics: ai-coding, claude-code, codex, opencode
- Language: TypeScript
- Homepage:
- Size: 5.59 MB
- Stars: 7
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Klovi
[](https://github.com/cookielab/klovi/actions/workflows/ci.yml)
[](LICENSE.md)
Klovi lets you browse, search, and present AI coding session history from
Claude Code, Codex CLI, Cursor, 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](https://brew.sh):
```bash
brew install --cask cookielab/tap/klovi
```
Or download the latest release for your platform from the
[Releases page](https://github.com/cookielab/klovi/releases).
### Browser-served npm package
```bash
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:
```bash
npx @cookielab.io/klovi
```
For programmatic embedding:
```ts
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 `
- `--no-browser`
## Development
```bash
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-cursor` - Cursor 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, Cursor, 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 lint` | Run Biome lint/format checks |
| `bun run storybook` | Start the design-system Storybook |
## Documentation
- [docs/architecture.md](docs/architecture.md) - runtime/package architecture
- [docs/components.md](docs/components.md) - UI layers and wrapper composition
- [docs/testing.md](docs/testing.md) - test setup and verification workflow
- [CONTENT_TYPES.md](CONTENT_TYPES.md) - JSONL content type catalog
## Contributing
See [CONTRIBUTING.md](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. "Cursor" and "OpenCode"
are trademarks of their respective owners. This project is not affiliated with,
endorsed by, or sponsored by Anthropic, OpenAI, or any other AI tool vendor.