Skip to content

docs: stop describing a two-backend program as a claude one - #7

Merged
tdwd merged 1 commit into
mainfrom
docs-two-backends
Sep 8, 2026
Merged

docs: stop describing a two-backend program as a claude one#7
tdwd merged 1 commit into
mainfrom
docs-two-backends

Conversation

@tdwd

@tdwd tdwd commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

A sweep for claude-specific copy across every user-visible surface, after the codex backend landed.

What was wrong

surface said
README opening "A Bubble Tea TUI over the Claude Code stream-json protocol"
WRITEUP subtitle "a terminal harness for Claude — running on your Max plan"
BUILD.md requirements only the claude CLI
-resume flag help "claude session id to resume"
entClaude constant a codex reply stored under the other backend's name

Plus the README's "why this is legitimate" argument, the run instructions, the env-scrub notes and the file table, all of which knew about one backend.

The feature list needed more than find-and-replace

Several bullets describe things codex does not do — the approval bar, the command palette, AskUserQuestion. Renaming "Claude" to "the agent" in those would have made them more misleading, not less, because the behaviour is genuinely claude-only. The list now states which backend it describes and points at Backends for the differences, rather than qualifying every line.

Deliberately unchanged

  • commandlist.go still describes /sysprompt as claude's response style. That is accurate — the feature is claude-only. What is wrong is that the command is still offered on codex, and that needs a capability set rather than new wording.
  • question.go's AskUserQuestion references. Claude-specific by definition.

Verified

go vet, full suite. The rename is compiler-checked and no reference to the old name survives anywhere, including the docs.

The README opened "A Bubble Tea TUI over the Claude Code stream-json protocol",
the WRITEUP called itself a harness for Claude on a Max plan, and BUILD.md
listed only the claude CLI as a requirement. All three were written when there
was one backend and none of them had caught up.

The feature list needed more than a find-and-replace. Several bullets describe
things codex does not do — the approval bar, the command palette,
AskUserQuestion — so a reader scanning it would conclude the codex backend does
them too. It now says which backend it describes and points at the section that
lists the differences, rather than qualifying every bullet.

entClaude becomes entAgent. A codex reply was being stored under a constant
named for the other backend, which is a small lie every reader of the codex
adapter had to step over.

-resume's help said "claude session id". It takes a claude session or a codex
thread now, and the picker sets it from either.
@tdwd
tdwd merged commit 469fa43 into main Sep 8, 2026
1 check passed
@tdwd
tdwd deleted the docs-two-backends branch September 8, 2026 09:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant