返回目录

staragent

维护状态: 活跃

siriusneo/staragent

轻量级智能体多路复用器,集成统一 Web 控制面板,支持 tmux、Tailscale 与多模型接入。

前往 GitHub
$ dsh plugin add staragent

56

星标

5

Fork

Python

语言

MIT

许可证

2026-05-29

创建于

2026-07-22

最近推送

采用 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,用于跨机器连接

安装步骤

  1. 01

    从源码安装:`pip install -e '.[dev]'`

  2. 02

    启动 Hub(仪表盘 + 本地节点):`staragent hub --host 0.0.0.0 --port 8080`

  3. 03

    在每台运行智能体的机器上:`pip install -e '.[dev]'`,然后 `export STARAGENT_NODE_TOKEN="<same token as the Hub>"`

  4. 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 适配与能力边界

DSH 适配生态相关
  • 基于 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 不会受任何影响。
2026-05-292026-07-22v0.1.1

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。

08数据与来源

  • 作者声明github.comfc49c7850450…

    StarAgent is an **agent multiplexer** for managing coding agent sessions across machines in a unified dashboard.

  • 作者声明github.comfc49c7850450…

    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 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。