vrr/codeburn
2
0
Fork 0
mirror of https://github.com/AgentSeal/codeburn.git synced 2026-07-31 11:55:33 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
codeburn/docs/providers/claude.md
ozymandiashh d92b9fea43 fix(claude): discover Claude Desktop/Cowork sessions in Windows MSIX installs 
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
2026-07-24 00:30:30 +03:00

3.7 KiB
Raw Permalink Blame History

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.