Skip to content

docs(readme): restore comparison + agents tables (v0.16.0 update)#24

Merged
cote-star merged 1 commit into
mainfrom
docs/readme-comparison-tables
Jun 4, 2026
Merged

docs(readme): restore comparison + agents tables (v0.16.0 update)#24
cote-star merged 1 commit into
mainfrom
docs/readme-comparison-tables

Conversation

@cote-star
Copy link
Copy Markdown
Owner

Summary

The v0.16.0 README rewrite cut two tables that the marketing landing actually needs:

  • How It Compares — restored after "How It Works", positioned where a reader is asking "why this not OpenHands/CrewAI/LangGraph?". 8 rows (was 13 pre-rewrite — tightened by folding per-feature differentiators into one row).
  • Supported Agents — replaces the previous one-line drop with a 6-row table covering Codex / Claude / Cursor CLI / Cursor IDE (new in v0.16.0) / Gemini / Hermes, showing on-disk source paths and --tool-calls behavior.

Result: README is 211 lines. Previous bloated version was 466, post-rewrite was 140. Still well inside marketing-register territory; every detail link goes to CLI_REFERENCE.md.

Test plan

  • npm run check:readme passes — runnable code blocks still work
  • CI conformance green

🤖 Generated with Claude Code

The v0.16.0 README rewrite cut two tables that the marketing landing
actually needs:

1. **How It Compares** — restored after "How It Works", where a new
   reader is deciding "why this not OpenHands/CrewAI/LangGraph?".
   Tightened from the prior 13 rows to 8 by folding the per-feature
   differentiators (timeline, summary, diff, handoff, messaging,
   context pack) into a single "Built-ins unique to chorus" row.
   Added a one-sentence positioning note: chorus is the evidence
   layer underneath whatever orchestrator you use, not a replacement.

2. **Supported Agents** — replaces the previous one-line drop with a
   6-row table showing where each agent stores sessions and how
   `--tool-calls` behaves. Picks up the v0.16.0 capability gains:
   the new Cursor IDE (app) adapter with its SQLite surface +
   Node 22.5 requirement, the uniform NOT_AVAILABLE warning for
   gemini/hermes, and the Hermes provisional scaffold. Footer
   references the CI-enforced read⊆search invariant.

Result: README is 211 lines (was 140 post-rewrite; previous bloated
version was 466). Marketing register preserved — no flag-by-flag
matrices, no per-feature deep dives, every detail link goes to
CLI_REFERENCE.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cote-star cote-star merged commit fbb327e into main Jun 4, 2026
3 checks passed
@cote-star cote-star deleted the docs/readme-comparison-tables branch June 4, 2026 11:48
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