mirror of
https://github.com/AgentSeal/codeburn.git
synced 2026-08-04 13:51:50 +00:00
d92b9fea43
The desktop sessions resolver returned a single per-platform path, so Microsoft Store (MSIX) installs of Claude Desktop were invisible: their data lives under %LOCALAPPDATA%\Packages\<Claude package>\LocalCache\Roaming\Claude\local-agent-mode-sessions and a filesystem junction workaround breaks Cowork's own file access (reported and verified in #611). getDesktopSessionsDir() becomes getDesktopSessionsDirs(): an ordered, deduped candidate list (override, then classic APPDATA, then MSIX packages matching Claude_* or *.Claude_*, existence-checked, lexicographically sorted; .config on Linux). Results are memoized per env-input tuple so the parser's per-file classification never rescans Packages. All call sites scan every candidate; macOS, Linux and classic Windows behavior unchanged. Fixes #611
69 lines
3.7 KiB
Markdown
69 lines
3.7 KiB
Markdown
# Claude
|
|
|
|
Anthropic Claude Code CLI and Claude Desktop's local agent mode.
|
|
|
|
- **Source:** `src/providers/claude.ts`
|
|
- **Loading:** eager (`src/providers/index.ts:1`)
|
|
- **Test:** none directly. Coverage comes from `tests/parser-claude-cwd.test.ts`, `tests/parser-filter.test.ts`, and `tests/parser-mcp-inventory.test.ts`, which exercise `src/parser.ts` end-to-end against fixture session files.
|
|
|
|
## Where it reads from
|
|
|
|
| Source | Path |
|
|
|---|---|
|
|
| Claude Code CLI | `$CLAUDE_CONFIG_DIR` if set, otherwise `~/.claude/projects/` |
|
|
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/local-agent-mode-sessions/` |
|
|
| Claude Desktop (Windows, classic) | `%APPDATA%/Claude/local-agent-mode-sessions/` |
|
|
| Claude Desktop (Windows, MSIX) | `%LOCALAPPDATA%/Packages/<Claude package>/LocalCache/Roaming/Claude/local-agent-mode-sessions/` |
|
|
| Claude Desktop (Linux) | `~/.config/Claude/local-agent-mode-sessions/` |
|
|
|
|
For Desktop, `findDesktopProjectDirs` walks up to 8 levels deep looking for `projects/` subdirectories, skipping `node_modules` and `.git`.
|
|
|
|
Desktop session roots are resolved in this order:
|
|
|
|
1. A non-empty `CODEBURN_DESKTOP_SESSIONS_DIR` overrides discovery and is the
|
|
only returned root.
|
|
2. macOS uses the single path shown above.
|
|
3. Windows always includes the classic path first. It then scans
|
|
`%LOCALAPPDATA%/Packages` for package directories whose names start with
|
|
`Claude_` or contain `.Claude_`, sorted by package name, and includes only
|
|
packages whose full MSIX sessions path exists as a directory.
|
|
4. Other platforms use the single Linux path shown above.
|
|
|
|
All returned roots are absolute, resolved, and deduplicated. Missing or
|
|
unreadable Windows package directories are ignored.
|
|
|
|
## Storage format
|
|
|
|
JSONL, one event per line, per session file. Sessions live under `<project>/<sessionId>.jsonl`.
|
|
|
|
## Parser
|
|
|
|
`createSessionParser` returns an empty async generator (`claude.ts:101-105`). Claude is a special case: `src/parser.ts` reads Claude JSONL files directly with full turn grouping, dedup of streaming message IDs, and MCP tool inventory extraction. The provider object exists only so `discoverSessions` can return Claude session sources alongside the others.
|
|
|
|
## Pricing
|
|
|
|
Claude Code reports total cache-write tokens in `usage.cache_creation_input_tokens`.
|
|
When available, it also splits those writes by duration in
|
|
`usage.cache_creation.ephemeral_5m_input_tokens` and
|
|
`usage.cache_creation.ephemeral_1h_input_tokens`. CodeBurn keeps the existing
|
|
aggregate cache-write token total for reports, but prices the 1-hour portion at
|
|
2x base input cost (1.6x the 5-minute cache-write rate exposed by LiteLLM).
|
|
If the split fields are missing, the parser falls back to the legacy behavior
|
|
and prices every cache write at the 5-minute rate.
|
|
|
|
## Caching
|
|
|
|
None at the provider level. The daily aggregation cache (`src/daily-cache.ts`) reuses prior computed days.
|
|
|
|
## Quirks
|
|
|
|
- The parser is in `src/parser.ts`, not in `src/providers/claude.ts`. Anything that changes Claude parsing belongs in `parser.ts`.
|
|
- Streaming responses produce duplicate message IDs across resumed sessions; `parser.ts` strips them via the global `seenMsgIds` Set.
|
|
- Model display names are mapped in `claude.ts:7-20`; add new versions there when Anthropic releases them.
|
|
|
|
## When fixing a bug here
|
|
|
|
1. Confirm whether the bug is in **discovery** (sessions not picked up) or **parsing** (sessions found but data wrong).
|
|
2. Discovery bugs live in `claude.ts:78-99`. Verify the directory layout you expect actually matches what Claude writes today.
|
|
3. Parsing bugs live in `src/parser.ts`. Look for `parseSessionFile`, `groupIntoTurns`, and `dedupeStreamingMessageIds`.
|
|
4. Add a fixture under `tests/fixtures/` and a test under `tests/parser-claude-cwd.test.ts` (or a new file). Do not mock the filesystem.
|