Refactor: shared utilities, plugin cleanup, and bug fixes by Vrtak-CZ · Pull Request #6 · cookielab/klovi

Vrtak-CZ · 2026-02-23T22:28:08Z

Summary

Shared utilities: Centralized JSON parsing, JSONL iteration, text truncation, ISO timestamp sorting, epoch-to-ISO conversion, discovery file scan helpers, and session ID normalization into shared modules
Plugin refactoring: Simplified discovery and parser logic across claude-code, codex-cli, and opencode plugins; removed deprecated Claude compatibility APIs; localized generated tool ID state; removed in-memory caching from stats and session index
Frontend improvements: Extracted App view state/routing concerns, shared session fetch hooks and error UI component, added plugin registry for tool summaries, and added stale request abort on cleanup
Bug fixes: Validated sub-agent session IDs, rejected empty session IDs in API routes, included pluginId in sub-agent sessions, bound server to localhost by default
Housekeeping: Renamed .claude to .agents with compatibility symlinks, gitignored local agent settings, excluded dist artifacts from typecheck

Test plan

bun run check — lint and format pass
bun run typecheck — no type errors
bun test — 560 tests pass, 0 failures

🤖 Generated with Claude Code

Approved design for making Klovi a universal AI coding session viewer with plugin system supporting Claude Code, Codex CLI, and OpenCode. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

21 tasks across 8 phases: plugin types, registry, Claude Code extraction, config/CLI, API wiring, frontend changes, Codex CLI plugin, OpenCode plugin. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

…gation Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Move project discovery, session listing, classifySessionTypes, aggregateSessions, and related helpers from src/server/parser/claude-dir.ts into src/server/plugins/claude-code/discovery.ts. Add discoverClaudeProjects() and listClaudeSessions() with pluginId support. Original file now re-exports for backward compatibility. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Move parseSession (renamed to loadClaudeSession), parseSubAgentSession, buildTurns, extractSubAgentMap, extractSlug, findPlanSessionId, findImplSessionId, and all helpers from src/server/parser/session.ts into src/server/plugins/claude-code/parser.ts. loadClaudeSession sets pluginId on returned Session objects. Original file now re-exports for backward compatibility. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add src/server/plugins/claude-code/index.ts implementing the ToolPlugin interface with id, displayName, project discovery, session listing, session loading, and resume command support. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add getCodexCliDir/setCodexCliDir and getOpenCodeDir/setOpenCodeDir config functions alongside existing Claude Code config, with full test coverage and proper save/restore in beforeEach/afterEach. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add CLI flags for Codex CLI and OpenCode data directories, update help text to say "AI coding sessions", show all scanned directories in the security warning, and change missing Claude Code dir from fatal error to warning so Klovi starts even if only other tools are installed. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Replace direct Claude Code function calls in API handlers with PluginRegistry. Create registry factory that auto-discovers plugins by checking data dir existence. Support compound session IDs (pluginId::sessionId) with backward compatibility. Search endpoint now aggregates sessions from all registered plugins. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

When a session has a pluginId, display the plugin's display name (e.g., "Claude Code") instead of the model name in the sidebar session list and global search results. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Replace hardcoded isClaudeModel() check with getResumeCommand() that returns the correct resume command per plugin (claude --resume, codex resume). Add frontend plugin registry for future tool-specific renderers and pluginId prop to ToolCall component. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add discovery module that scans ~/.codex/sessions/ recursively for JSONL session files, extracts SessionMeta from the first line, and groups sessions by cwd to identify projects. Includes summary extractors for Codex-specific tool names (command_execution, file_change, web_search). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Parse Codex CLI JSONL sessions into the shared Session type. Maps item.completed events to ContentBlocks: agent_message to text, reasoning to thinking, command_execution/file_change/mcp_tool_call/ web_search to ToolCallWithResult. Tracks token usage from turn.completed events. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Wire the Codex CLI plugin into the server registry (auto-discovered when ~/.codex exists) and register frontend summary extractors and input formatters for Codex-specific tool names. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add project discovery and session listing for SST's OpenCode tool, which stores sessions in a SQLite database. Uses schema introspection to handle schema variations gracefully. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Parse OpenCode messages and parts from SQLite into shared Turn types. Handles text, reasoning, and tool parts with completed/error/pending states. Includes comprehensive tests with temp SQLite databases. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Wire OpenCode plugin into server registry (checks for opencode.db) and frontend plugin registry. Add plugin entry point with no resume command since OpenCode doesn't support session resumption. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Update README, architecture, components, testing, and content types docs to reflect the plugin system supporting Claude Code, Codex CLI, and OpenCode. Add new CLI flags, plugin system architecture, frontend plugin registry docs, expanded test file listing, and Codex CLI / OpenCode content type catalogs. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Update countProjects() in stats.ts to use the PluginRegistry instead of scanning only the Claude Code projects directory. This ensures the dashboard project count reflects all discovered tools. Recent session counting still uses Claude Code directory only (relies on file mtimes). Update stats tests to isolate tool directories. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

keep existing claude-oriented tooling working while introducing agents naming for the project configuration and skills directory. Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

…formatting Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Browsers encode special characters like `::` as `%3A%3A` in URL path segments, causing session lookups to fail with 400 because parseSessionId couldn't find the `::` separator in the encoded string. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

…ail view Replace plain-text plugin/model identifier with a styled plugin badge, remove model name and git branch from session list and search results, and display git branch in the session detail view instead. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Cover lightbox rendering, keyboard/click close behavior, listener cleanup, and SmartToolOutput integration (open/close on image click). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Codex CLI updated its JSONL format to wrap everything in {type, timestamp, payload} envelopes. This adds support for the new format while preserving backward compatibility with the old flat format. - Parse session_meta envelope to extract uuid, cwd, timestamps - Match rollout-*-{uuid}.jsonl filenames in addition to {uuid}.jsonl - Extract user messages from event_msg/user_message payloads - Normalize response_item/function_call events with call_id matching - Handle task_started, task_complete, token_count, agent_reasoning Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Provide Codex JSONL demo transcripts with comparable project and session coverage to the existing Claude demo data so mixed-source browsing can be exercised locally. Co-Authored-By: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

Add demo data for opencode including: - Session data with JWT auth and dashboard bug fix examples - Project data with Kanban board creation example Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Vrtak-CZ and others added 30 commits February 23, 2026 23:14

docs: add multi-tool support design document

5310e40

Approved design for making Klovi a universal AI coding session viewer with plugin system supporting Claude Code, Codex CLI, and OpenCode. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs: add multi-tool support implementation plan

4aaa23c

21 tasks across 8 phases: plugin types, registry, Claude Code extraction, config/CLI, API wiring, frontend changes, Codex CLI plugin, OpenCode plugin. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: define plugin type system for multi-tool support

848b230

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: implement PluginRegistry with project merging and session aggre…

ffd52a5

…gation Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: create Claude Code plugin entry point

5da2028

Add src/server/plugins/claude-code/index.ts implementing the ToolPlugin interface with id, displayName, project discovery, session listing, session loading, and resume command support. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: register Codex CLI plugin

07426e5

Wire the Codex CLI plugin into the server registry (auto-discovered when ~/.codex exists) and register frontend summary extractors and input formatters for Codex-specific tool names. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: OpenCode plugin discovery via bun:sqlite

c960b00

Add project discovery and session listing for SST's OpenCode tool, which stores sessions in a SQLite database. Uses schema introspection to handle schema variations gracefully. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat: register OpenCode plugin

5f3fccc

Wire OpenCode plugin into server registry (checks for opencode.db) and frontend plugin registry. Add plugin entry point with no resume command since OpenCode doesn't support session resumption. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

refactor: remove legacy compatibility shims, use plugins directly

1bb41bb

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

chore(skills): remove claude co-author trailer from commit template

91857d2

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

fix(server): avoid Bun-only runtime imports in plugin loading path

eff2839

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

fix(routing): normalize session IDs across plugins and APIs

7f32331

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

fix(server): bind to localhost by default and add --host option

8017539

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

chore(types): exclude generated dist artifacts from typecheck

741ea3d

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

fix(stats): aggregate dashboard metrics across all registered plugins

9a6188b

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(frontend): extract App view state and routing concerns

1facc39

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(frontend): use plugin registry for tool summaries and input …

cf68415

…formatting Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

Vrtak-CZ and others added 15 commits February 23, 2026 23:21

fix(api): validate claude sub-agent session IDs

b727bfa

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(frontend): share session fetch hooks and URL builders

cfd4534

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

fix(frontend): abort stale useFetch requests on cleanup

735c53f

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(stats): remove in-memory caching from scanStats

ffd8e35

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(codex-cli): remove session index cache

4c70e27

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(config): remove unused stats cache path

a6e7f4e

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(opencode): localize generated tool ID state

1fec360

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

docs(agents): forbid caching in project rules

fd6acf7

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(server): reduce complexity and tighten parser typings

2746f8b

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

style(repo): apply biome formatting and import ordering

2006039

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(parsers): localize remaining generated tool ID state

e5e0016

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(codex-cli): make generated turn IDs deterministic

674bd4d

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

refactor(frontend): share fetch error UI component

184c63f

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

fix(api): reject empty raw session IDs in session route

891a91c

Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

chore: gitignore local agent settings file

23106e4

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Vrtak-CZ force-pushed the refactor branch from 676af7a to cdbfc8e Compare February 23, 2026 22:32

chore(skills): add AI co-author trailers to commit template

cd27a4c

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Vrtak-CZ force-pushed the refactor branch from cdbfc8e to cd27a4c Compare February 23, 2026 22:36

Vrtak-CZ and others added 10 commits February 23, 2026 23:49

chore: add chrome-devtools-mcp for browser debugging

bf29e13

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix: biome schema version

14c2e81

chore(docs): remove obsolete plan documents

e53b5cd

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

chore: biome config fmt

ba042c4

test(ui): add ImageLightbox test coverage

8b9aaf0

Cover lightbox rendering, keyboard/click close behavior, listener cleanup, and SmartToolOutput integration (open/close on image click). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

feat(demo-data): add opencode session and project dataset samples

3de1186

Add demo data for opencode including: - Session data with JWT auth and dashboard bug fix examples - Project data with Kanban board creation example Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Vrtak-CZ merged commit 834a598 into main Feb 24, 2026
1 check passed

Vrtak-CZ deleted the refactor branch February 25, 2026 12:52

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Refactor: shared utilities, plugin cleanup, and bug fixes#6

Refactor: shared utilities, plugin cleanup, and bug fixes#6
Vrtak-CZ merged 73 commits intomainfrom
refactor

Vrtak-CZ commented Feb 23, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

Vrtak-CZ commented Feb 23, 2026

Summary

Test plan

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant