Skip to content

docs: describe the settled v0.8.0 surface, not the release that made it - #37

Merged
colevels merged 1 commit into
mainfrom
docs/post-080-descriptions
Jul 23, 2026
Merged

docs: describe the settled v0.8.0 surface, not the release that made it#37
colevels merged 1 commit into
mainfrom
docs/post-080-descriptions

Conversation

@colevels

Copy link
Copy Markdown
Owner

The docs were accurate — bun run src/index.ts help matches the README's command block verbatim, and CLAUDE.md's protocol/ring/timeout numbers all check out against the source. What was stale is the framing: both files opened as v0.8.0 release notes ("Status: proof of concept", "v0.8.0 is the subtraction", the never-tagged-0.7.0 archaeology). That's the first thing a reader meets and the last thing they need, now that 0.8.0 is where everyone starts.

README

  • Top banner deleted — the page opens on the pitch.
  • One status line before Commands links to a new What changed in v0.8.0 section at the end, which absorbs everything the banner carried: the five removed tabs commands, the three removed flags and why each was a flag that could only ever be wrong, init's one-skill change (with the "re-run tabbrew init" note for anyone set up before 0.8.0), the v0.6.0 pin, and the never-tagged 0.7.0.
  • Inline design rationale stays where it explains a current absence (--out/--port, "it does not wait for an answer", the two-skills note); only the tabs-history.jsonl line was reworded, since it leaned on the banner for context.

CLAUDE.md

  • ## Status: past the POC## The shape of this repo, keeping only durable instruction: the subtractive bias, registry.ts + git log as the authority on what exists, a don't reintroduce list that records where each removal's replacement lives (tabs watch/loop, tabs push/checktabs suggest), and the v0.7.0 trap.

Two drift fixes

  • src/bridge.ts (added in e25def8) was described in the architecture prose but missing from the project-layout tree.
  • docs/commands.html was credited to v0.7.0; the page itself is titled tabbrew CLI v0.8.0.

Also, outside this diff

package.json's description still described a docs-push tool and predated the tabs bridge — updated here. The GitHub repo description and topics were changed directly (not versionable): the description now leads with the tab loop, and tab-management + device-flow were added to the existing eight topics.

Verification

  • bun run typecheck and bun test pass (20/20).
  • bun run src/index.ts help output is unchanged and still matches the README's command block.
  • Every src/*.ts now appears in CLAUDE.md's layout tree; the #what-changed-in-v080 anchor resolves.
  • No reference to a removed command survives outside the history section and the two places explaining why init deletes tabbrew-auto.

🤖 Generated with Claude Code

The docs were accurate but still written as release notes: the README opened
on a "Status: proof of concept" banner listing what v0.8.0 removed, and
CLAUDE.md opened on the same archaeology. That is the first thing a reader
meets and the last thing they need, now that 0.8.0 is the version everyone
starts on.

README: drop the top banner, open on the pitch, and collect everything it
carried — the removed commands and flags, the init skill change, the v0.6.0
pin, the never-tagged 0.7.0 — into one "What changed in v0.8.0" section at the
end, linked from a single line above the command list.

CLAUDE.md: retitle the opener to "The shape of this repo" and keep only what
is durable instruction — the subtractive bias, registry.ts as the authority on
what exists, a don't-reintroduce list that records where each removal's
replacement lives, and the v0.7.0 trap.

Two drift fixes along the way: src/bridge.ts was described in the architecture
prose but missing from the project-layout tree, and docs/commands.html was
credited to v0.7.0 when the page itself is titled v0.8.0.

package.json's description (like the GitHub one, updated separately) still
described a docs-push tool and predated the tabs bridge entirely.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@colevels
colevels merged commit 5731ad2 into main Jul 23, 2026
1 check passed
@colevels
colevels deleted the docs/post-080-descriptions branch July 23, 2026 20:45
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