采用 MIT 协议、以 tmux 为先的智能体多路复用器,通过统一网页仪表盘跨机器管理编程智能体会话(Codex / Claude Code / OpenCode);作为生态工具收录于 DeepSeek Harness 插件目录。
DSH 适配
生态相关
作者声明
安全审计
未审计
最后核验
2026-09-03
许可证
MIT
01它能帮你完成什么?
在一处集中管理多台机器上不同工作目录里的多个编程智能体 CLI 会话(Codex / Claude Code / OpenCode)
统一网页仪表盘展示每个会话的状态,并提供聊天控制台、终端与文件浏览器用于实时交互
在多台机器上运行编程智能体、希望用一个仪表盘实时监控并交互的开发者
让编程智能体会话长存,并能从任意设备访问
经由集中式 Hub 呈现的长存 tmux 会话,其他机器作为 StarAgent Node 通过 Tailscale 接入
希望拥有持久、跨机器的智能体会话,可在手机或笔记本上直接接入、不必反复输入 `/resume` 的工程师
02如何接入 DeepSeek Harness?
前置条件
- 带 pip 的 Python——README 通过 `pip install -e '.[dev]'` 安装
- tmux——所有编程智能体 CLI 会话都运行在长存 tmux 会话中
- 每台机器都安装并连上 Tailscale,用于跨机器连接
安装步骤
- 01
从源码安装:`pip install -e '.[dev]'`
- 02
启动 Hub(仪表盘 + 本地节点):`staragent hub --host 0.0.0.0 --port 8080`
- 03
在每台运行智能体的机器上:`pip install -e '.[dev]'`,然后 `export STARAGENT_NODE_TOKEN="<same token as the Hub>"`
- 04
启动基于 Tailscale 的 Node:`sudo tailscale up --ssh`,再 `staragent node-ts --sudo`(非 Tailscale 网络上用 `staragent node`)
验证接入成功
- 在 Hub 上确认 Node 可达:`staragent verify-node <node-host-or-100.x-ip>`
- 打开 `http://<hub-node>:8080`,用 `staragent hub` 打印的 token 登录
03DSH 适配与能力边界
基于 tmux 的智能体会话
在 tmux 中启动的编程智能体 CLI(Codex / Claude Code / OpenCode)→在仪表盘上呈现并可控制的长存 tmux 会话
统一网页仪表盘
运行中的 StarAgent Hub + Node→无需额外软件,即可从任何带浏览器的设备(手机、笔记本)控制智能体
通过 Tailscale 跨机器连接
处于同一 Tailscale 网络的机器→统一的网络层;远程机器作为 StarAgent Node 接入
每会话的聊天 / 终端 / 文件浏览器
一个活跃的智能体会话→每个会话详情页都带轻量聊天控制台,外加终端与文件浏览器
04适合谁?何时不该用?
适合
- 在多台机器上运行编程智能体、希望用一个仪表盘实时监控并交互的开发者
- 希望拥有持久、跨机器的智能体会话,可在手机或笔记本上直接接入、不必反复输入 `/resume` 的工程师
不适合
- README 提醒:项目当前面向个人使用、仍在活跃开发中,稳定版本将在后续发布。
- README 提醒:项目主要靠 vibe coding 构建,可能存在潜在 bug,使用前请知悉。
05兼容性、维护与安全提示
- README 提醒:项目当前面向个人使用、仍在活跃开发中,稳定版本将在后续发布。
- README 提醒:项目主要靠 vibe coding 构建,可能存在潜在 bug,使用前请知悉。
- Node 命令需要提权:`staragent node-ts` 在 `tailscale serve` 需要 root 时使用 `--sudo`,且须先确保 Tailscale 已启动(`tailscale up --ssh`),否则会打印该命令提示先执行。
- 网页界面按只读设计:它完全以解析器方式实现,服务器上的 tmux CLI 会话才是唯一事实来源——手动 SSH 进入并附着 tmux 不会受任何影响。
MIT · 维护者说明项目面向个人使用、仍在活跃开发中;最新版本 v0.1.1
06常见问题
StarAgent 会以原生 DeepSeek Harness(dsh)运行时方式运行吗?
不会。README 并未声明原生 dsh 运行时集成。StarAgent 作为生态工具收录于 DeepSeek Harness 插件目录——它是一个智能体多路复用器,通过网页仪表盘在 tmux 中统一管理编程智能体 CLI 会话(Codex、Claude Code、OpenCode)。是否有 dsh 专属配置请查看维护者仓库。
怎么安装 StarAgent?
用 `pip install -e '.[dev]'` 从源码安装,然后启动 Hub(`staragent hub --host 0.0.0.0 --port 8080`,它运行仪表盘并作为本地节点);在每台运行智能体的机器上执行 `pip install -e '.[dev]'`、导出 `STARAGENT_NODE_TOKEN`,并用 `staragent node-ts --sudo`(或在非 Tailscale 网络上用 `staragent node`)启动 Node。
前置条件有哪些?
需要带 pip 的 Python(README 通过 `pip install -e '.[dev]'` 安装);需要 tmux(每个智能体 CLI 会话都运行在长存 tmux 会话中);跨机器连通用到的每台机器都要安装并连上 Tailscale。
怎么验证远程 Node?
在 Hub 机器上运行 `staragent verify-node <node-host-or-100.x-ip>` 确认 Node 可达,然后在 Hub 仪表盘填入它的 Host 与 Port(例如 `100.x.x.x` 和 `8081`)。也可以打开 `http://<hub-node>:8080`,用 `staragent hub` 打印的 token 登录。
StarAgent 可用于生产环境吗?
目前还不行。README 提醒:项目当前面向个人使用、仍在活跃开发中(稳定版后续发布),且主要靠 vibe coding 构建,可能存在潜在 bug。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图,输出自包含 HTML,支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库,统一智能体记忆、知识 RAG 与技能。
nocobase
作者 nocobase
开源的 AI + 无代码应用搭建平台:AI 在久经生产验证的底层基础设施与所见即所得的无代码界面之上工作,帮你快速构建 CRM、ERP 等业务系统,兼顾速度与可靠性。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程,从 0 到 1 系统学习智能体工作流框架。
08数据与来源
StarAgent is an **agent multiplexer** for managing coding agent sessions across machines in a unified dashboard.
We just need a lightweight tmux wrapper for Codex / Claude Code that supports cross-machine connections and can be acces…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-09-03。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
