feat(usage): add OpenCode as a usage provider

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.

[mhaadiabu]

Problem

The Usage page only covers Claude Code and Codex. If you drive OpenCode, every token it spends is invisible there, which makes the page's totals quietly wrong for anyone who uses more than one CLI.

What changed

OpenCode is now a third usage provider. It does not write JSONL transcripts like the other two CLIs; it stores every message in one WAL-mode sqlite database at ${XDG_DATA_HOME:-~/.local/share}/opencode/opencode.db. The usage scan treats that database as one more source:

• UsageProviderKind gains "opencode" and USAGE_CONTRACT_VERSION bumps 4 → 5, so an older client paired with a newer environment renders partial coverage instead of failing schema decode.
• apps/server/src/usage/opencodeTranscriptReader.ts opens the store read-only through node:sqlite (already in the server's dependency set) and streams assistant rows out. The db, -wal, and -shm siblings stat into one (size, mtime) identity so the existing scan cache invalidates on live writes.
• Each row is exactly one billed request, so unlike the Claude content-block repeats or Codex re-emitted events there is nothing to dedupe. OpenCode's stored cost is trusted as provider-reported (a literal 0 is a real answer from free providers), so most rows skip the LiteLLM fallback entirely.
• OpenCode treats reasoning tokens as disjoint from output; its own total sums them. Output absorbs reasoning here to reconcile with that total while keeping the contract's "reasoning is a subset of output" invariant.
• Web and mobile presentation tables gain entries reusing the existing OpenCodeIcon.

Before / after

Before:

After:

Verification

• Focused tests for the new parser and reader (vp test run src/usage/): 46 passed, covering cost trust, reasoning absorption, junk-row rejection, mtime gating, and read-only DB access against a real sqlite file.
• Targeted typecheck clean for contracts, server, web, mobile; lint clean on touched files.
• Validated the extraction SQL against a production opencode.db (~19.5k billable rows, zero malformed).

---

Note

Medium Risk
Touches usage aggregation and a contract version bump, but changes are read-only local SQLite access with isolated parsing and no auth or billing paths.

Overview
Adds OpenCode as a third usage source alongside Claude Code and Codex, so Usage charts and totals include its local session spend.

The shared contract gains "opencode" in UsageProviderKind and USAGE_CONTRACT_VERSION bumps 4 → 5 so older clients can still render partial coverage. On the server, OpenCode is read from opencode.db under ${XDG_DATA_HOME:-~/.local/share}/opencode (not JSONL): a new reader treats the DB plus WAL/SHM as one cacheable pseudo-file, queries assistant rows with tokens via SQLite JSON, and maps them through parseOpenCodeMessage (provider-reported cost, no dedupe keys, reasoning folded into output for contract invariants). UsageService routes listing and parsing through that path while reusing the existing scan cache (decode now accepts opencode entries). Web and mobile usage UI pick up label, purple styling, and OpenCodeIcon; user docs mention OpenCode.

^{Reviewed by Cursor Bugbot for commit 61975b2. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add opencode as a usage provider across server, mobile, and web

• Introduces opencodeTranscriptReader.ts which reads assistant messages from OpenCode's SQLite store, exposing statOpenCodeDatabase, listOpenCodeDatabaseFiles, and readOpenCodeRecords
• UsageService.make branches on the opencode provider to call the new reader instead of the transcript reader; cache keying and dedup remain unchanged
• parseOpenCodeMessage converts OpenCode message JSON into a UsageRecord, mapping reasoning tokens into output and trusting stored non-negative costs
• Mobile and web usage UIs register opencode with label OpenCode and color #8b5cf6; web adds an OpenCodeIcon mark
• Bumps USAGE_CONTRACT_VERSION from 4 to 5 and extends UsageProviderKind to include 'opencode' in usage.ts
• Risk: consumers pinned to contract version 4 will not recognize the new provider literal and may reject or discard opencode entries; decodeScanCache now accepts 'opencode' so persisted caches round-trip correctly

^{Macroscope summarized 61975b2.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 07798611-dbfb-41af-bf3d-e574ba71aa82

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit c6fea1f16bbf29bd9ea54c33850c872b878fd154. Configure here.}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial production OpenCode integration, including a new SQLite/WAL reader, usage parser, shared contract provider, and web/mobile presentation. Existing usage requests now inspect and aggregate another local store, creating cross-component runtime behavior beyond a small isolated change.

^{You can add or adjust custom eligibility rules. Learn more.}

[t3dotgg]

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

We're closing this PR as we clean up the T3 Code backlog. Thank you for taking the time to put this together.

#8456 is the active path for OpenCode usage reporting. We recorded the useful differences from this branch, but they do not require a second implementation to remain open.

If you believe we closed this in error, please reopen the PR and leave a comment explaining what we missed.