Skip to content

docs: add cross-reference to Hive (alternative form factor)#17

Open
tt-a1i wants to merge 1 commit into
mainfrom
docs/add-hive-cross-reference
Open

docs: add cross-reference to Hive (alternative form factor)#17
tt-a1i wants to merge 1 commit into
mainfrom
docs/add-hive-cross-reference

Conversation

@tt-a1i

@tt-a1i tt-a1i commented May 18, 2026

Copy link
Copy Markdown
Member

Summary

squad and Hive solve the same problem — coordinating
multiple CLI agents (Claude / Codex / Gemini / OpenCode) on one project —
with different form factors. This PR adds a short "Other form factors"
section near the bottom of both READMEs (zh + en) so people landing on
squad can pick the right tool by workflow, rather than discovering Hive
months later.

The framing is intentionally neutral:

  • squad — pure CLI + SQLite, lives in tmux, SSH-friendly, zero background process
  • Hive — visual workbench in the browser, task graph UI, one-click restart all

Closing line is "the two projects don't replace each other; pick by workflow"
so it reads as informational, not promotional.

Hive's own README has a mirrored section pointing back at squad (commit
fee546c in the Hive repo).

Test plan

  • Both READMEs render correctly on GitHub
  • Section placement is consistent (zh + en both before Requirements / 系统要求)
  • Link to https://hivehq.dev/ resolves

squad and Hive solve the same problem (multi-agent CLI collaboration)
with different form factors. Adding a short section near the bottom
of both READMEs so users can pick the right tool by workflow:

- squad — pure CLI + SQLite, lives in tmux, SSH-friendly, zero daemon
- Hive  — visual workbench, runs in a browser, easier to demo

The framing is "two projects don't replace each other; pick by workflow"
to keep it informational rather than promotional.
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