codeburn/docs/providers/README.md

Provider Docs

One file per provider integration. If you are fixing a bug or adding a feature scoped to a single provider, read the file for that provider first; it tells you which file to edit, where on disk the source data lives, and what edge cases the test suite already covers.

For the architectural picture, see ../architecture.md.

Provider Index

Eager (always loaded)

Provider	Storage	Source	Test
Claude	JSONL (no parser)	src/providers/claude.ts	none (covered indirectly)
Cline	JSON	src/providers/cline.ts	tests/providers/cline.test.ts
Codex	JSONL	src/providers/codex.ts	tests/providers/codex.test.ts
Copilot	JSONL	src/providers/copilot.ts	tests/providers/copilot.test.ts
Droid	JSONL	src/providers/droid.ts	tests/providers/droid.test.ts
Gemini	JSON / JSONL	src/providers/gemini.ts	none
IBM Bob	JSON	src/providers/ibm-bob.ts	tests/providers/ibm-bob.test.ts
KiloCode	JSON	src/providers/kilo-code.ts	tests/providers/kilo-code.test.ts
Kiro	JSON	src/providers/kiro.ts	tests/providers/kiro.test.ts
Kimi	JSONL	src/providers/kimi.ts	tests/providers/kimi.test.ts
Mistral Vibe	JSON / JSONL	src/providers/mistral-vibe.ts	tests/providers/mistral-vibe.test.ts
OpenClaw	JSONL	src/providers/openclaw.ts	tests/providers/openclaw.test.ts
Pi	JSONL	src/providers/pi.ts	tests/providers/pi.test.ts
OMP	JSONL	src/providers/pi.ts	tests/providers/omp.test.ts
Qwen	JSONL	src/providers/qwen.ts	none
Roo Code	JSON	src/providers/roo-code.ts	tests/providers/roo-code.test.ts

Lazy (loaded on first call)

Provider	Storage	Source	Test
Antigravity	protobuf over RPC	src/providers/antigravity.ts	none
Crush	SQLite (per-project)	src/providers/crush.ts	tests/providers/crush.test.ts
Cursor	SQLite	src/providers/cursor.ts	tests/providers/cursor.test.ts
Cursor Agent	text / JSONL	src/providers/cursor-agent.ts	tests/providers/cursor-agent.test.ts
Goose	SQLite	src/providers/goose.ts	none
OpenCode	SQLite	src/providers/opencode.ts	tests/providers/opencode.test.ts

Shared

Helper	Used by	Source
vscode-cline-parser	cline, ibm-bob, kilo-code, roo-code	src/providers/vscode-cline-parser.ts

File Format

Each provider doc has the same structure:

1. One-line summary of what the provider integrates.
2. Where it reads from on disk (or over RPC).
3. Storage format and validation rules.
4. Caching (which cache layer, if any).
5. Deduplication key so you understand cross-provider dedup.
6. Quirks that have bitten us before.
7. When fixing a bug here as a checklist.

If you add a new provider, copy claude.md as a template and fill in your provider's specifics. Update this index, and prefer adding a real test fixture under tests/providers/.