feat(server): replace Claude Agent SDK runtime with a direct stream-json CLI driver (subscription billing) by akarabach · Pull Request #1 · akarabach/t3code

akarabach · 2026-05-16T13:51:14Z

Why

Driving Claude through @anthropic-ai/claude-agent-sdk could bill usage against pay-per-token API credits. We need Claude usage to draw from the user's Claude subscription (Pro/Max) instead. The SDK's query() is what spawns and drives the claude binary, so removing the SDK runtime (while keeping its types) lets us own the process and its environment directly.

What

New ClaudeCliTransport.ts — an SDK-free driver that spawns the native claude binary and speaks its stream-json IPC protocol directly.
ClaudeAdapter.ts — the createQuery seam now uses the new transport; the SDK import is import type only.
ClaudeProvider.ts — the capabilities/auth probe no longer executes SDK runtime code (uses the transport's initialize() handshake).
@anthropic-ai/claude-agent-sdk moved dependencies → devDependencies (types only — zero runtime code ships).
Added protocol integration tests driving a fake CLI.

How it works now

createQuery → makeClaudeCliQuery spawns claude --output-format stream-json --verbose --input-format stream-json …, then:

stdout: NDJSON is framed and emitted as the same SDKMessage stream the adapter already consumes — no downstream changes.
stdin: user messages + control requests (interrupt, setModel, setPermissionMode, setMaxThinkingTokens) are written as NDJSON.
Permissions: with a canUseTool callback the CLI runs with --permission-prompt-tool stdio, so can_use_tool requests arrive on the same stdout stream and are answered on stdin — no separate MCP server.
An initialize handshake is sent on startup (also powers the auth/capabilities probe).

Because no SDK code runs, the spawned process uses the local claude login → subscription billing (provided ANTHROPIC_API_KEY is not in the server environment).

Verification

Typecheck clean; 300 provider tests + 5 new transport tests pass; production bundle builds with zero runtime SDK import.
⚠️ Not yet verified against a live claude binary with a real subscription — needs a manual end-to-end pass (streaming, tool approval, resume, claude auth status).

Screenshot

TODO: screenshot

…tgg#1972)

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Co-authored-by: julius <julius0216@outlook.com>

…gdotgg#1979)

…ingdotgg#1949)

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: cursor[bot] <206951365+cursor[bot]@users.noreply.github.com> Co-authored-by: codex <codex@users.noreply.github.com>

…ingdotgg#1995) Co-authored-by: codex <codex@users.noreply.github.com>

…otgg#1997)

)

Co-authored-by: Julius Marminge <jmarminge@gmail.com>

…d names (pingdotgg#1994)

)

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

…2005)

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: codex <codex@users.noreply.github.com>

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: cursor[bot] <206951365+cursor[bot]@users.noreply.github.com>

…tgg#2004) Co-authored-by: Cursor Agent <cursoragent@cursor.com>

…ingdotgg#1541) Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Julius Marminge <julius0216@outlook.com> Co-authored-by: codex <codex@users.noreply.github.com>

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: cursor[bot] <206951365+cursor[bot]@users.noreply.github.com>

Co-authored-by: codex <codex@users.noreply.github.com>

…gg#2024) Co-authored-by: Julius Marminge <julius0216@outlook.com> Co-authored-by: codex <codex@users.noreply.github.com>

Co-authored-by: Julius Marminge <julius0216@outlook.com>

Co-authored-by: Julius Marminge <julius@macmini.local>

…tus check (pingdotgg#2616)

Co-authored-by: codex <codex@users.noreply.github.com>

Co-authored-by: Julius Marminge <julius0216@outlook.com>

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Julius Marminge <juliusmarminge@users.noreply.github.com> Co-authored-by: Julius Marminge <julius0216@outlook.com>

- Restrict release workflow defaults to read-only access - Grant `id-token` only to the publish job - Document safe handling for `pull_request_target` in PR size checks

Co-authored-by: Julius Marminge <julius@macmini.local>

Replace the @anthropic-ai/claude-agent-sdk runtime with a direct stream-json child-process driver so usage bills against the user's Claude subscription instead of pay-per-token API credits. The SDK is now a type-only devDependency (zero runtime code, types unchanged). - ClaudeCliTransport.ts (new): spawn + NDJSON framing + control protocol (interrupt/setModel/setPermissionMode/setMaxThinkingTokens), can_use_tool permission bridge over stdio, initialize handshake - ClaudeAdapter.ts: createQuery -> makeClaudeCliQuery; import type only - ClaudeProvider.ts: capabilities/auth probe ported off SDK runtime - package.json: SDK moved dependencies -> devDependencies - ClaudeCliTransport.test.ts (new): protocol integration tests

akarabach · 2026-05-16T13:52:50Z

Superseded by the upstream PR pingdotgg#2729 (correct base).

juliusmarminge and others added 30 commits April 12, 2026 18:22

Preserve live stream subscriptions across explicit reconnects (pingdo…

94d13a2

…tgg#1972)

Migrate chat scrolling and branch lists to LegendList (pingdotgg#1953)

96c9306

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

window controls overlay (windows&linux) (pingdotgg#1969)

dff8784

Co-authored-by: julius <julius0216@outlook.com>

fix(desktop): increase backend readiness timeout from 10s to 30s (pin…

850c912

…gdotgg#1979)

fix(web): replace turn strip overlay gradients with mask-image fade (p…

57d7746

…ingdotgg#1949)

Add shell snapshot queries for orchestration state (pingdotgg#1973)

f7fa62a

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: cursor[bot] <206951365+cursor[bot]@users.noreply.github.com> Co-authored-by: codex <codex@users.noreply.github.com>

fix: avoid copy button overlapping long code blocks (pingdotgg#1985)

1bf048e

Pad composer model picker to prevent ring clipping (pingdotgg#1992)

f2205bd

Allow empty server threads to bootstrap new worktrees (pingdotgg#1936)

801b83e

Prevent live thread branches from regressing to temp worktree names (p…

77fcad3

…ingdotgg#1995) Co-authored-by: codex <codex@users.noreply.github.com>

fix: add pointer cursor to the permissions mode select trigger (pingd…

047a0a6

…otgg#1997)

docs: Document environment prep before local development (pingdotgg#1975

9b29be9

)

feat: Add Kiro editor support to open picker (pingdotgg#1974)

5f7becf

Co-authored-by: Julius Marminge <jmarminge@gmail.com>

feat: show full thread title in a tooltip when hovering sidebar threa…

cadd708

…d names (pingdotgg#1994)

Clear tracked RPCs on reconnect (pingdotgg#2000)

f5ecca4

Use latest user message time for thread timestamps (pingdotgg#1996)

6f69934

fix: lost provider session recovery (pingdotgg#1938)

d18e43b

Fix thread timeline autoscroll and simplify branch state (pingdotgg#2002

33dadb5

)

Warm sidebar thread detail subscriptions (pingdotgg#2001)

569fea8

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Fix new-thread draft reuse for worktree defaults (pingdotgg#2003)

5f7ec73

Refresh git status after branch rename and worktree setup (pingdotgg#…

9dcea68

…2005)

Cache provider status and gate desktop startup (pingdotgg#1962)

008ac5c

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: codex <codex@users.noreply.github.com>

Improve shell PATH hydration and fallback detection (pingdotgg#1799)

2e42f3f

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: cursor[bot] <206951365+cursor[bot]@users.noreply.github.com>

Backfill projected shell summaries and stale approval cleanup (pingdo…

c9b07d6

…tgg#2004) Co-authored-by: Cursor Agent <cursoragent@cursor.com>

fix(claude): emit plan events for TodoWrite during input streaming (p…

0d28026

…ingdotgg#1541) Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Julius Marminge <julius0216@outlook.com> Co-authored-by: codex <codex@users.noreply.github.com>

Nightly release channel (pingdotgg#2012)

409ff90

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: cursor[bot] <206951365+cursor[bot]@users.noreply.github.com>

Fix nightly desktop product name (pingdotgg#2025)

9ff31f8

Co-authored-by: codex <codex@users.noreply.github.com>

Add filesystem browse API and command palette project picker (pingdot…

44afe78

…gg#2024) Co-authored-by: Julius Marminge <julius0216@outlook.com> Co-authored-by: codex <codex@users.noreply.github.com>

Fix terminal Cmd+Backspace on macOS (pingdotgg#2027)

7968f27

Co-authored-by: Julius Marminge <julius0216@outlook.com>

feat(web): add tooltip to composer file mention pill (pingdotgg#1944)

28cb9db

ben-vargas and others added 26 commits May 8, 2026 23:52

Fix remote pairing CORS responses (pingdotgg#2594)

e0f3abd

Update deployment command in release workflow (pingdotgg#2610)

6b9feb1

Collapse long user messages by default (pingdotgg#2180)

99efaa0

Co-authored-by: Julius Marminge <julius0216@outlook.com>

[codex] Fix Vercel release web deploy scope (pingdotgg#2611)

39371c6

Co-authored-by: Julius Marminge <julius@macmini.local>

[codex] Fix Vercel Turbo env forwarding (pingdotgg#2612)

6efdf67

Co-authored-by: Julius Marminge <julius@macmini.local>

[codex] Fix hosted channel bootstrap (pingdotgg#2613)

3c32bc8

Co-authored-by: Julius Marminge <julius@macmini.local>

chore(release): prepare v0.0.23

b793401

fix(codex): use longer and shared auth probe timeout for provider sta…

6ab8f93

…tus check (pingdotgg#2616)

Alias stable releases to the router domain (pingdotgg#2636)

e64c19f

Remove outline styling from git success toast action (pingdotgg#2639)

16c69ba

Preserve Codex probe results across scoped teardown (pingdotgg#2638)

8fc3179

Co-authored-by: codex <codex@users.noreply.github.com>

Optimize VCS diff loading to be up to 98% faster (pingdotgg#2586)

5165b8c

Co-authored-by: Julius Marminge <julius0216@outlook.com>

Stabilize project grouping settings selector (pingdotgg#2629)

447236d

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Julius Marminge <juliusmarminge@users.noreply.github.com> Co-authored-by: Julius Marminge <julius0216@outlook.com>

Use Effect child process for editor launches (pingdotgg#2659)

d15909a

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Julius Marminge <juliusmarminge@users.noreply.github.com> Co-authored-by: Julius Marminge <julius0216@outlook.com>

Reduce chat timeline activity rerenders (pingdotgg#2660)

a41f489

Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: Julius Marminge <juliusmarminge@users.noreply.github.com> Co-authored-by: Julius Marminge <julius0216@outlook.com>

Refactor composer refs and context providers (pingdotgg#2664)

b83e9c9

Constrain provider update popover overflow (pingdotgg#2669)

7e20b23

Harden GitHub workflow permissions

556c424

- Restrict release workflow defaults to read-only access - Grant `id-token` only to the publish job - Document safe handling for `pull_request_target` in PR size checks

Simplify workspace package builds and deps (pingdotgg#2676)

f92e1e1

Skip healthy env reconnects after browser resume (pingdotgg#2677)

90eea04

feat(marketing): Made marketing site less cringe (pingdotgg#2681)

34bb18c

Back off VCS remote refresh failures (pingdotgg#2686)

4120e94

[codex] add diagnostics resource history (pingdotgg#2685)

9e632f5

Co-authored-by: Julius Marminge <julius@macmini.local>

Exclude workspace packages from desktop runtime deps (pingdotgg#2688)

ea20e80

chore(release): prepare v0.0.24

d1e85c4

github-actions Bot added vouch:trusted PR author is trusted by repo permissions or the VOUCHED list. size:XXL labels May 16, 2026

akarabach closed this May 16, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(server): replace Claude Agent SDK runtime with a direct stream-json CLI driver (subscription billing)#1

feat(server): replace Claude Agent SDK runtime with a direct stream-json CLI driver (subscription billing)#1
akarabach wants to merge 199 commits into
mainfrom
read-claude-streamed-messages

akarabach commented May 16, 2026

Uh oh!

akarabach commented May 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants

Conversation

akarabach commented May 16, 2026

Why

What

How it works now

Verification

Screenshot

Uh oh!

akarabach commented May 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

20 participants