vrr/codeburn
2
0
Fork 0
mirror of https://github.com/AgentSeal/codeburn.git synced 2026-10-20 11:44:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
codeburn/docs/providers/command-code.md
Resham Joshi 063e42796d
feat(providers): add Command Code (#1658) 
* feat: Command Code support

Reads the cmd CLI's session transcripts at
~/.commandcode/projects/<slug>/<id>.jsonl (CODEBURN_COMMANDCODE_DIR moves
the root). Checkpoint and prompt sidecars are skipped.

usage.inputTokens includes cacheReadTokens, so fresh input is
inputTokens - cacheReadTokens. The recorded costUsd is kept per call
(costFromBilling); a call without one is priced from tokens and marked
estimated. Forks copy parent message ids into a new file, so calls dedupe
by message id across sessions.

Desktop: Electron sandbox read path, macOS and Windows change watchers,
Windows tab colour. No quota adapter.

* fix(command-code): dedupe on meta.messageId, not the 8-hex line id

The top-level id is randomUUID().slice(0, 8) and only unique within one
file, so calls from unrelated sessions could collide and vanish.
meta.messageId is a full uuid that survives forks. Fixture ids now use
the real 8-hex shape.

* test(command-code): check sidecar skipping by file name, not a posix path
2026-10-07 00:18:50 +02:00

3.3 KiB
Raw Blame History

Command Code

Command Code (cmd), Langbase's coding agent CLI (commandcode.ai, npm command-code).

  • Source: src/providers/command-code.ts
  • Loading: eager (src/providers/index.ts)
  • Test: tests/providers/command-code.test.ts, fixture tests/fixtures/command-code/ (redacted real transcripts)

Where it reads from

~/.commandcode/projects/<project-slug>/<session-id>.jsonl. CODEBURN_COMMANDCODE_DIR replaces ~/.commandcode; the CLI itself has no override and follows HOME.

Only <id>.jsonl files are sessions. The CLI writes sidecars next to each one (.checkpoints.jsonl, .prompts.jsonl, .meta.json, .share.json), and discovery skips any file whose name has a second dot. ~/.commandcode/history.jsonl is prompt history and is never read, nor is anything else outside projects/.

Storage format

JSONL, session format v3:

  • First line: {type: "session", version, id, timestamp, cwd, parentSession?}.
  • Then {type: "message", id, parentId, timestamp, message: {role, content, meta: {messageId}}, model?, usage?}. content is a string or an array of text, thinking, tool_use and tool_result blocks.
  • Assistant lines carry model (e.g. moonshotai/Kimi-K3, deepseek/deepseek-v4-pro) and usage: {inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens, costUsd}.

Token model

One call per assistant message line with usage.

  • usage.inputTokens includes cacheReadTokens. CodeBurn's input is fresh input, so it stores inputTokens - cacheReadTokens (never below 0). Taking inputTokens as is counts every cache read twice. Checked on real data: inputTokens >= cacheReadTokens on every call, and costUsd fits one set of per-token rates only when input is taken as cache-inclusive.
  • cacheReadTokens and cacheWriteTokens map to cache read and cache write.
  • outputTokens already includes reasoning (no separate count), so reasoningTokens is 0.

Pricing

costUsd is the dollars Command Code charged for the call (its own rates, e.g. DeepSeek at the discounted price). When it is present, including 0 for free models, it is kept as is with costFromBilling. A call without it is priced from tokens through the shared catalog and marked costIsEstimated; a model id the catalog does not know shows up under codeburn models --unpriced.

Deduplication

command-code:<message.meta.messageId>, a full uuid. The top-level id is only 8 hex characters and unique within one file, so sessions can collide on it; it is used only as a fallback and for turnId. Forking a session copies the parent's message lines verbatim into a new session file, so the key is not scoped to a session.

Quirks

  • Project is the last segment of the session header's cwd, falling back to the slug directory.
  • Tool names are Command Code's own (shell_command, read_file, grep, agent, ...) and are mapped to CodeBurn's names. agent calls with a subagent_type count as subagents; activate_skill counts as a skill.

When fixing a bug here

  1. Discovery: the projects/<slug>/<id>.jsonl walk and the sidecar filter.
  2. Accounting: the input/cache split above. Recheck it against costUsd if the CLI changes its usage block.
  3. Add a case to tests/providers/command-code.test.ts; do not mock the filesystem.