MIT-licensed, tmux-first agent multiplexer for managing coding-agent sessions (Codex / Claude Code / OpenCode) across machines through one web dashboard; listed in the DeepSeek Harness plugin catalog as an ecosystem tool.
DSH integration
Ecosystem-related
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-03
License
MIT
01What can it help you accomplish?
Manage multiple coding-agent CLI sessions (Codex / Claude Code / OpenCode) across different working directories from one place
A unified web dashboard showing every session’s status, with a chat console, terminal and file explorer for real-time interaction
Developers running coding agents on several machines who want one dashboard to monitor and interact with them in real time
Keep coding-agent sessions long-lived and reachable from any device
Long-lived tmux sessions surfaced through a centralized Hub, with other machines joined as StarAgent Nodes over Tailscale
Engineers who want persistent, cross-machine agent sessions they can attach to from a phone or laptop without re-typing `/resume`
02How to install into DeepSeek Harness
Prerequisites
- Python with pip — the README installs via `pip install -e '.[dev]'`
- tmux — all coding-agent CLI sessions run inside long-lived tmux sessions
- Tailscale installed and connected on every machine for cross-machine connectivity
Installation steps
- 01
Install from source: `pip install -e '.[dev]'`
- 02
Start the Hub (dashboard + local node): `staragent hub --host 0.0.0.0 --port 8080`
- 03
On each agent machine: `pip install -e '.[dev]'` then `export STARAGENT_NODE_TOKEN="<same token as the Hub>"`
- 04
Start a Tailscale-backed Node: `sudo tailscale up --ssh` then `staragent node-ts --sudo` (or `staragent node` on a non-Tailscale network)
Verify the integration
- From the Hub, confirm a Node is reachable: `staragent verify-node <node-host-or-100.x-ip>`
- Open `http://<hub-node>:8080` and log in with the token printed by `staragent hub`
03DSH integration and capability boundaries
tmux-backed agent sessions
Coding-agent CLI (Codex / Claude Code / OpenCode) launched in tmux→Long-lived tmux sessions shown and controllable from the dashboard
Unified web dashboard
Running StarAgent Hub + Nodes→Control agents from any browser-capable device (phones, laptops) with no extra software
Cross-machine connectivity via Tailscale
Machines on the same Tailscale network→A unified network layer; remote machines join as StarAgent Nodes
Per-session chat / terminal / file explorer
An active agent session→A lightweight chat console plus a terminal and file explorer on each session detail page
04Who is it for? When not to use it?
Good for
- Developers running coding agents on several machines who want one dashboard to monitor and interact with them in real time
- Engineers who want persistent, cross-machine agent sessions they can attach to from a phone or laptop without re-typing `/resume`
Not for
- The README warns the project is currently intended for personal use and under active development; a stable version will be released later.
- The README warns the project was primarily built with vibe coding and may contain potential bugs; keep this in mind before using it.
05Compatibility, maintenance and safety notes
- The README warns the project is currently intended for personal use and under active development; a stable version will be released later.
- The README warns the project was primarily built with vibe coding and may contain potential bugs; keep this in mind before using it.
- Node commands need elevated access: `staragent node-ts` uses `--sudo` when `tailscale serve` requires root, and Tailscale must be up (`tailscale up --ssh`) first or it prints that command to run.
- The web UI is read-only by design: it is implemented entirely as a parser, and the tmux CLI sessions on the server remain the ground truth — it never gets in the way of manually SSHing in and attaching to tmux.
MIT · maintainer states it is for personal use and under active development; latest release v0.1.1
06Frequently asked questions
Does StarAgent run as a native DeepSeek Harness (dsh) runtime?
No. The README does not claim a native dsh runtime integration. StarAgent is listed in the DeepSeek Harness plugin catalog as an ecosystem tool — an agent multiplexer for managing coding-agent CLI sessions (Codex, Claude Code, OpenCode) inside tmux via a web dashboard. Check the maintainer's repo for any dsh-specific setup.
How do I install StarAgent?
Install from source with `pip install -e '.[dev]'`, then start the Hub (`staragent hub --host 0.0.0.0 --port 8080`) which runs the dashboard and acts as a local node; on each agent machine run `pip install -e '.[dev]'`, export `STARAGENT_NODE_TOKEN`, and start a Node with `staragent node-ts --sudo` (or `staragent node` on a non-Tailscale network).
What are the prerequisites?
Python with pip (install is via `pip install -e '.[dev]'`), tmux (every agent CLI session runs inside a long-lived tmux session), and Tailscale installed and connected on every machine for cross-machine connectivity.
How do I verify a remote Node?
From the Hub machine run `staragent verify-node <node-host-or-100.x-ip>` to confirm the Node is reachable, then add its Host and Port (e.g. `100.x.x.x` and `8081`) in the Hub dashboard. You can also open `http://<hub-node>:8080` and log in with the token printed by `staragent hub`.
Is StarAgent production-ready?
Not yet. The README warns the project is currently intended for personal use and under active development (a stable version will come later), and was primarily built with vibe coding and may contain potential bugs.
07Related DSH workflows
archify
by tt-a1i
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.
openviking
by volcengine
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
nocobase
by nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.
learn-harness-engineering
by walkinglabs
Harness engineering beginner tutorial, from 0 to 1
08Data and sources
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…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-03. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.