Add multi-agent source support

Author: LyleMi

README.md

@@ -6,21 +6,21 @@
 
 ![Status: MVP](https://img.shields.io/badge/status-MVP-f2c94c)
 ![Local first](https://img.shields.io/badge/local--first-yes-2f855a)
-![Platform: Windows first](https://img.shields.io/badge/platform-Windows%20first-0078d4)
+![Platform: Cross-platform](https://img.shields.io/badge/platform-cross--platform-0078d4)
 ![Backend: Go](https://img.shields.io/badge/backend-Go-00ADD8)
 ![Frontend: Vue 3](https://img.shields.io/badge/frontend-Vue%203-42b883)
 ![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)
 
-AgentMeter is a local-first dashboard for understanding Codex session usage:
+AgentMeter is a local-first dashboard for understanding coding-agent session usage:
 tokens, estimated cost, timing, session history, and tool-call behavior.
 
-It reads local Codex session files, indexes them into SQLite, and shows the data
+It reads local agent JSONL session files, indexes them into SQLite, and shows the data
 in a private desktop UI. No proxy, no cloud service, no telemetry.
 
 ## Why AgentMeter
 
 Coding agents can generate a lot of useful local session data, but that data is
-hard to inspect directly. AgentMeter turns Codex JSONL sessions into answers you
+hard to inspect directly. AgentMeter turns local JSONL sessions into answers you
 can actually use:
 
 - How many sessions did I run?
@@ -33,6 +33,8 @@ can actually use:
 ## Features
 
 - Overview dashboard with sessions, tokens, estimated cost, daily usage, and model usage.
+- Multiple local source roots, with Codex, Claude Code, and generic JSONL detection.
+- Agent-level usage grouping for developers who run several coding agents side by side.
 - Searchable session history with parse status and raw source traceability.
 - Session detail timeline with model calls, tool calls, metadata, and source paths.
 - Tool-call analytics with call counts, success/failure counts, and durations.
@@ -50,16 +52,19 @@ AgentMeter is designed to stay local:
 - Does not require a cloud account.
 - Stores normalized data in a local SQLite database.
 
-The default database path is:
+The default database path follows the host OS:
 
 ```text
-%LOCALAPPDATA%\AgentMeter\agentmeter.sqlite
+Windows: %LOCALAPPDATA%\AgentMeter\agentmeter.sqlite
+macOS:   ~/Library/Application Support/AgentMeter/agentmeter.sqlite
+Linux:   $XDG_DATA_HOME/AgentMeter/agentmeter.sqlite or ~/.local/share/AgentMeter/agentmeter.sqlite
 ```
 
-The default Codex source path is:
+Default source roots are detected from local agent homes when they exist:
 
 ```text
-%USERPROFILE%\.codex
+~/.codex
+~/.claude
 ```
 
 ## Quick Start
@@ -83,9 +88,9 @@ source files change, starts AgentMeter, and opens:
 http://127.0.0.1:34115
 ```
 
-On first launch, click **Index Now** in the app. AgentMeter defaults to
-`%USERPROFILE%\.codex`, so no source path setup is required unless your Codex
-sessions live somewhere else.
+On first launch, click **Index Now** in the app. AgentMeter defaults to detected
+local agent homes such as `~/.codex` and `~/.claude`. In **Settings**, enter one
+source root per line when you use multiple agents or keep session logs elsewhere.
 
 Build the frontend and start local HTTP mode manually:
 
@@ -114,21 +119,22 @@ wails dev
 ## How It Works
 
 ```text
-Codex JSONL -> scanner/parser -> SQLite -> Go query service -> Vue dashboard
+Agent JSONL -> scanner/parser -> SQLite -> Go query service -> Vue dashboard
 ```
 
 When the source path is a Codex home directory, AgentMeter scans `sessions\`
 first and then `archived_sessions\`, keeping the active copy when both contain
-the same relative JSONL path. A direct directory of saved JSONL output is also
-supported.
+the same relative JSONL path. When the source path is a Claude Code home,
+AgentMeter scans `projects/`. A direct directory of saved JSONL output is also
+supported through the generic JSONL adapter.
 
 ## Current Status
 
-AgentMeter is currently an MVP focused on Codex on Windows. The repository
+AgentMeter is currently an MVP for local coding-agent JSONL usage. The repository
 already includes:
 
 - Go backend with SQLite migrations and local app configuration.
-- Codex JSONL discovery, parsing, normalization, and incremental indexing.
+- Codex, Claude Code, and generic JSONL discovery, parsing, normalization, and incremental indexing.
 - Normalized sessions, events, token usage, model calls, and tool calls.
 - Vue 3 + TypeScript frontend using Ant Design Vue and ECharts.
 - MVP screens for Overview, Sessions, Session Detail, Tools, and Settings.
@@ -146,8 +152,7 @@ go test ./...
 
 ## Roadmap
 
-Planned directions include packaged Windows builds, macOS/Linux support, more
-coding-agent adapters, export formats, project grouping, custom pricing, and
+Planned directions include packaged builds, more coding-agent adapters, export formats, project grouping, custom pricing, and
 richer timeline views.
 
 See [Roadmap](docs/roadmap.md) for details.
@@ -163,4 +168,4 @@ See [Roadmap](docs/roadmap.md) for details.
 ## Contributing
 
 Issues and pull requests are welcome, especially for parser edge cases, pricing
-updates, Windows packaging, and adapters for other coding agents.
+updates, packaging, and adapters for other coding agents.

docs/architecture.md

@@ -36,7 +36,8 @@ AgentMeter
 
   backend
     source discovery
-    Codex parser
+    agent source adapters
+    JSONL parser
     ingestion pipeline
     SQLite repository
     pricing service
@@ -52,7 +53,7 @@ AgentMeter
 ## Data Flow
 
 ```text
-discover Codex path
+discover configured agent source roots
   -> scan session JSONL files
   -> parse raw events
   -> normalize to internal event model
@@ -67,7 +68,8 @@ Proposed Go layout:
 ```text
 internal/
   app/
-  codex/
+  agent/
+  sessionjsonl/
   db/
   ingest/
   model/
@@ -79,14 +81,15 @@ internal/
 
 Responsibilities:
 
-- `codex`: understand Codex JSONL shape and convert it to normalized records.
+- `agent`: detect source roots such as Codex, Claude Code, or generic JSONL directories.
+- `sessionjsonl`: understand supported JSONL event shapes and convert them to normalized records.
 - `ingest`: scan, hash, deduplicate, and index files.
 - `db`: SQLite connection, migrations, repositories.
 - `model`: normalized domain structs.
 - `pricing`: model aliases, pricing table, cost calculation.
 - `query`: read models for UI screens.
 - `export`: JSON and CSV export.
-- `platform`: Windows path discovery and future platform-specific logic.
+- `platform`: OS-specific database and default source path discovery.
 
 ## UI Shape
 
@@ -120,7 +123,7 @@ Session Detail should show:
 
 ## Runtime Rules
 
-- AgentMeter must not modify Codex session files.
+- AgentMeter must not modify source session files.
 - AgentMeter must not upload data.
 - UI should bind to local desktop runtime, not a public interface.
 - Indexing should be incremental.

docs/data-model.md

@@ -1,6 +1,6 @@
 # Data Model
 
-The database stores normalized records derived from Codex session JSONL. Raw
+The database stores normalized records derived from local coding-agent JSONL. Raw
 source files remain the source of truth.
 
 ## Core Entities
@@ -12,7 +12,7 @@ Tracks configured local data sources.
 Fields:
 
 - `id`
-- `kind` such as `codex`
+- `kind` such as `codex`, `claude`, or `jsonl`
 - `name`
 - `root_path`
 - `sessions_path`
@@ -38,13 +38,14 @@ Fields:
 
 ### sessions
 
-One Codex session.
+One normalized agent session.
 
 Fields:
 
 - `id`
 - `source_id`
 - `source_file_id`
+- `session_key`
 - `codex_session_id`
 - `project_path`
 - `model`
@@ -63,6 +64,9 @@ Fields:
 - `event_count`
 - `parse_status`
 
+`session_key` is the generic identity shown in the UI. `codex_session_id` is
+kept for backward compatibility with older databases and API clients.
+
 ### events
 
 Normalized timeline events.

docs/project-brief.md

@@ -2,8 +2,8 @@
 
 ## One-line Description
 
-AgentMeter is an open-source, cross-platform-ready local dashboard for measuring
-coding agent session usage, starting with Codex on Windows.
+AgentMeter is an open-source, cross-platform local dashboard for measuring
+coding agent session usage from local JSONL session files.
 
 ## Problem
 
@@ -21,9 +21,12 @@ AgentMeter focuses on that gap:
 
 ## Initial Scope
 
-The first version supports:
+The current version supports:
 
-- Codex local sessions on Windows;
+- Codex local sessions;
+- Claude Code local sessions;
+- generic JSONL session directories;
+- multiple configured source roots for users running several coding agents;
 - token usage from local session data;
 - session duration from local JSONL timestamps;
 - tool-call statistics from local session events;
@@ -32,7 +35,6 @@ The first version supports:
 
 ## Non-goals For MVP
 
-- Multi-agent support beyond Codex.
 - Proxy or gateway mode.
 - Cloud sync.
 - Team dashboards.
@@ -43,7 +45,7 @@ The first version supports:
 
 ## User
 
-The first user is a developer who uses Codex locally and wants to understand:
+The first user is a developer who uses local coding agents and wants to understand:
 
 - token burn;
 - estimated cost;
@@ -55,7 +57,7 @@ The first user is a developer who uses Codex locally and wants to understand:
 
 ## Product Principles
 
-- Read-only against Codex data.
+- Read-only against source session data.
 - Prefer actual usage data over estimation.
 - Clearly label unknown, missing, and estimated values.
 - Keep data local unless the user explicitly exports it.
@@ -64,8 +66,8 @@ The first user is a developer who uses Codex locally and wants to understand:
 
 ## First Usable Version
 
-The first useful build should let a user open AgentMeter, point it at a Codex
-data directory if needed, index sessions, and inspect:
+The first useful build should let a user open AgentMeter, point it at one or
+more local agent data directories if needed, index sessions, and inspect:
 
 - overview totals;
 - daily usage;

docs/roadmap.md

@@ -2,11 +2,11 @@
 
 ## Phase 0: Discovery
 
-Goal: understand Codex session data well enough to design the parser safely.
+Goal: understand local coding-agent session data well enough to design the parser safely.
 
 Tasks:
 
-- Locate Codex session directories on Windows.
+- Locate Codex and Claude Code session directories across supported OSes.
 - Collect representative local JSONL samples.
 - Document event types found in real sessions.
 - Identify where token usage appears.
@@ -32,23 +32,23 @@ Tasks:
 - Add SQLite dependency.
 - Add migration runner.
 - Add app configuration storage.
-- Add Windows Codex path discovery.
+- Add cross-platform database and default source path discovery.
 
 Deliverables:
 
 - runnable Wails app;
 - empty shell UI;
 - local SQLite database creation.
 
-## Phase 2: Codex Indexer
+## Phase 2: Agent Indexer
 
-Goal: index Codex sessions into SQLite.
+Goal: index local coding-agent sessions into SQLite.
 
 Tasks:
 
 - Implement source discovery.
 - Implement JSONL scanner.
-- Implement Codex parser.
+- Implement Codex, Claude Code, and generic JSONL parsing.
 - Normalize sessions, events, token usage, and tool calls.
 - Add incremental indexing based on path, size, modified time, and hash.
 - Add parse warnings.
@@ -82,15 +82,17 @@ Tasks:
 
 Deliverables:
 
-- usable local dashboard for Codex sessions.
+- usable local dashboard for local coding-agent sessions.
 
 ## Phase 4: Packaging
 
-Goal: make Windows usage easy.
+Goal: make cross-platform usage easy.
 
 Tasks:
 
 - Windows app build.
+- macOS app build.
+- Linux app build.
 - Installer or portable zip.
 - Local database path decision.
 - Log file location.
@@ -104,8 +106,7 @@ Deliverables:
 
 Possible additions:
 
-- macOS and Linux support.
-- Claude Code adapter.
+- More complete Claude Code adapter coverage.
 - Gemini CLI adapter.
 - OpenCode adapter.
 - CSV export.

frontend/src/App.vue

@@ -19,9 +19,14 @@ const settings = ref<Settings | null>(null)
 const indexing = ref(false)
 const refreshKey = ref(0)
 
-const hasSource = computed(() => Boolean(settings.value?.sourcePath))
-const sourceStatusLabel = computed(() => (hasSource.value ? 'Source ready' : 'Source missing'))
-const sourcePathDisplay = computed(() => settings.value?.sourcePath || 'Configure a local JSONL source in Settings')
+const hasSource = computed(() => Boolean(settings.value?.sourcePaths?.length || settings.value?.sourcePath))
+const sourceStatusLabel = computed(() => (hasSource.value ? 'Sources ready' : 'Sources missing'))
+const sourcePathDisplay = computed(() => settings.value?.sourcePath || 'Configure local JSONL sources in Settings')
+const sourceSummary = computed(() => {
+  const count = settings.value?.sourcePaths?.length || 0
+  if (count > 1) return `${count} local sources`
+  return sourcePathDisplay.value
+})
 
 const selectedKeys = computed(() => {
   if (route.path.startsWith('/sessions')) return ['sessions']
@@ -99,7 +104,7 @@ onBeforeUnmount(() => {
           </div>
           <div class="brand-copy">
             <div class="brand-title">AgentMeter</div>
-            <div class="brand-subtitle">Local Codex usage</div>
+            <div class="brand-subtitle">Local agent usage</div>
           </div>
         </div>
         <div class="nav-section-label">Inspect</div>
@@ -120,9 +125,9 @@ onBeforeUnmount(() => {
               <span class="source-dot"></span>
               <span>{{ sourceStatusLabel }}</span>
             </div>
-            <span class="source-label">Local source</span>
+            <span class="source-label">Local sources</span>
             <a-typography-text class="source-path" :ellipsis="{ tooltip: sourcePathDisplay }">
-              {{ sourcePathDisplay }}
+              {{ sourceSummary }}
             </a-typography-text>
           </div>
           <div class="header-actions">