From ba54b2d6d3363cb6488b2a29dc36d1c0aaab7430 Mon Sep 17 00:00:00 2001
From: tt-a1i <2801884530@qq.com>
Date: Mon, 18 May 2026 20:19:50 +0800
Subject: [PATCH] docs: add cross-reference to Hive as an alternative form
 factor
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

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.
---
 README.md       | 10 ++++++++++
 README.zh-CN.md | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/README.md b/README.md
index 2190b61..481af3b 100644
--- a/README.md
+++ b/README.md
@@ -293,6 +293,16 @@ squad receive worker --json
 squad send manager @all "API contract changed, update your implementations"
 ```
 
+## Other form factors
+
+squad takes the **pure CLI + SQLite + one terminal per agent** route. It fits best when you:
+
+- live in tmux, or SSH into remote dev boxes
+- want to keep your own terminal emulator
+- don't want any extra background process running
+
+If you'd prefer a visual workbench — task graph UI, one-click restart all, workspace sidebar — take a look at [Hive](https://hivehq.dev/). Hive drives Claude / Codex / Gemini / OpenCode the same way (real CLI processes), but the PTYs run in a browser. The two projects don't replace each other; pick by workflow.
+
 ## Requirements
 
 - Rust 1.77+ (for building)
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 273f0d6..cabf22f 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -287,6 +287,16 @@ squad receive worker --json
 squad send manager @all "API 接口已更新，请更新你们的实现"
 ```
 
+## 别的形态
+
+squad 走的是 **纯 CLI + SQLite + 每个 agent 一个终端** 的路线，最适合：
+
+- 习惯 tmux、或通过 SSH 进远端服务器开发
+- 想保留自己的终端模拟器
+- 不想跑任何额外后台进程
+
+如果你更想要一个可视化工作台——任务图 UI、一键重启所有 worker、侧边栏切换 workspace——可以看看 [Hive](https://hivehq.dev/)。Hive 同样把 Claude / Codex / Gemini / OpenCode 当真实 CLI 进程驱动，PTY 跑在浏览器里。两个项目互不替代，按工作流挑就行。
+
 ## 系统要求
 
 - Rust 1.77+（编译需要）