针对 AI 代理 TUIs 优化的 tmux Web GUI,支持 iOS safari 和 mac 系统带有键盘快捷键
Agentboard is a Web GUI for tmux that's optimized for agent TUI's (claude, codex, etc). A lighter-weight, agent-optimized alternative to Blink, Termux, etc.
Run your desktop/server, then connect from your phone or laptop over Tailscale/LAN. You get a shared workspace across devices.
…| Terminal | Sessions | Hibernating |
|---|---|---|
| Terminal | Controls |
|---|---|
brew install tmux / apt install tmux)brew tap gbasin/tap
brew install agentboard
agentboardnpm install -g @gbasin/agentboard
agentboardOr run directly:
npx @gbasin/agentboardThen open http://localhost:4040 (or http://:4040 from another device).
For persistent deployment, see systemd/README.md (Linux) or launchd/README.md (macOS).
Requires Bun 1.3.14+ (see Troubleshooting).
bun install
bun run devOpen http://:5173 (Vite dev server). In production, UI is served from the backend port (default 4040).
Production:
bun run build
bun run startFor persistent deployment, see systemd/README.md (Linux) or launchd/README.md (macOS).
Use the built-in scanner to report security and maintenance risk for direct dependencies:
bun run deps:riskMachine-readable output:
bun run deps:risk:jsonPolicy:
bun audit --json findings and is aggregated by severity (low, moderate, high, critical).bun outdated and classifies version lag as major, minor, or patch behind latest.high (high + critical fail).critical only (bun run deps:risk:ci) while existing upstream high advisories are tracked; maintenance findings are warnings for prioritization.You can override the security threshold with --threshold (or DEPENDENCY_RISK_FAIL_ON):
bun run deps:risk -- --threshold moderate| Action | Mac | Windows/Linux |
|---|---|---|
| Previous session | Ctrl+Option+[ |
Ctrl+Shift+[ |
| Next session | Ctrl+Option+] |
Ctrl+Shift+] |
| Jump to session 1-9 | Ctrl+Option+1..9 |
Ctrl+Shift+1..9 |
| New session | Ctrl+Option+N |
Ctrl+Shift+N |
| Kill session | Ctrl+Option+X |
Ctrl+Shift+X |
…HOSTNAME controls which interfaces the server binds to (default 127.0.0.1 for localhost-only). With the default localhost binding, if Tailscale is detected the server also binds to your Tailscale IP automatically. Set to 0.0.0.0 to listen on all interfaces. A HOSTNAME that merely equals the machine hostname is treated as auto-exported by the environment (containers and some CI images do this) and ignored with a warning, keeping the localhost default.
Security note: Agentboard has no built-in authentication. Anyone who can reach the server has full access to your terminal sessions, including the ability to run commands as your user. The default localhost binding is safe. Tailscale provides network-level auth for remote access. Avoid setting
HOSTNAME=0.0.0.0on untrusted networks (public WiFi, shared LANs) without an additional access control layer.
DISCOVER_PREFIXES lets you discover and control windows from other tmux sessions. If unset, all sessions except the managed one are discovered.
PRUNE_WS_SESSIONS removes orphaned agentboard-ws-* tmux sessions on startup (set to false to disable).
AGENTBOARD_PREFER_WINDOW_NAME (default false) controls how externally-discovered sessions are labeled. When false, the tmux session name is used (more meaningful than auto-renamed window names that follow the running process under tmux automatic-rename on). Set to true to use the tmux window name when it is non-empty and distinct from the session name — useful when you keep one shared session (e.g. dev) with one explicitly-named window per project (myapp, infra, ...).
TERMINAL_MODE selects terminal I/O strategy: pty (default, grouped session) or pipe-pane (PTY-less, works in daemon/systemd/docker without -t).
AGENTBOARD_CLAUDE_NO_FLICKER controls how Agentboard launches new Claude Code windows. By default, Agentboard sets CLAUDE_CODE_NO_FLICKER=1 on newly-created panes so Claude uses its fullscreen renderer with mouse scrolling, click handling, in-app selection, and flat memory usage for long conversations. Set AGENTBOARD_CLAUDE_NO_FLICKER=0 (or false) before starting Agentboard to launch Claude without that env var. Fullscreen rendering requires Claude Code v2.1.89 or later; older Claude Code versions should ignore the env var and use the classic renderer.
Reasons to opt out: fullscreen rendering keeps the conversation in the alternate screen buffer instead of native terminal scrollback, so terminal-level search/copy workflows behave differently; Claude also captures mouse events unless you disable its mouse capture. Inside Claude Code, run /tui default to switch a session back to the classic renderer, or launch Claude with CLAUDE_CODE_DISABLE_MOUSE=1 if you want fullscreen rendering but native mouse selection.
AGENTBOARD_TMUX_SET_CLIPBOARD controls whether Agentboard enables tmux's set-clipboard on when it attaches. By default it does, so copies made inside a session land in a tmux paste buffer that Agentboard can relay to the browser clipboard (important on iOS Safari, where the async OSC 52 path can't satisfy the user-gesture rule). Because set-clipboard is a server-global tmux option, this affects your whole tmux server and is not reverted on disconnect — set AGENTBOARD_TMUX_SET_CLIPBOARD=0 (or false) to leave your tmux configuration untouched.
AGENTBOARD_TMUX_SYNC controls whether Agentboard's tmux client advertises synchronized-update support (tmux -T sync, tmux 3.2+). By default it does, so tmux wraps redraws in DEC 2026 frame markers and the browser terminal paints each frame atomically instead of tearing during fast fullscreen repaints (e.g. Claude Code's no-flicker renderer). The flag applies only to Agentboard's own client and does not change tmux server options. Set AGENTBOARD_TMUX_SYNC=0 (or false) to disable.
When you open an externally-discovered tmux session, Agentboard attaches through a per-connection session grouped with it (agentboard-ws--x--), so focus in the browser stays independent of your own tmux clients. Two side effects: these derived sessions appear in tmux ls while a viewer is attached (they are removed on switch-away and disconnect, and pruned at startup), and killing the raw session keeps its windows alive until the last grouped viewer switches away (tmux keeps a group's windows while any member session exists).
TERMINAL_MONITOR_TARGETS (pipe-pane only) polls tmux to detect closed targets (set to false to disable).
VITE_ALLOWED_HOSTS allows access to the Vite dev server from other hostnames. Useful with Tailscale MagicDNS - add your machine name (e.g., nuc) to access the dev server at http://nuc:5173 from other devices on your tailnet.
All persistent data is stored in ~/.agentboard/: session database (agentboard.db) and logs (agentboard.log). Override paths with AGENTBOARD_DB_PATH and LOG_FILE.
AGENTBOARD_INACTIVE_MAX_AGE_HOURS limits History sessions shown in the UI to those with recent activity (default: 24 hours). Older sessions remain in the database but are not displayed or processed for orphan rematch. The env var name is kept for compatibility.
AGENTBOARD_EXCLUDE_PROJECTS filters out sessions from specific project directories (comma-separated). Use `` to exclude sessions with no project path. Useful for hiding automated/spam sessions.
AGENTBOARD_SKIP_MATCHING_PATTERNS controls which orphan sessions skip expensive window matching (comma-separated). Defaults: `` (headless Codex exec sessions), /private/tmp/*, /private/var/folders/*, /var/folders/*, /tmp/*. Patterns support trailing * for prefix matching. Set to empty string to disable skip matching entirely.
AGENTBOARD_HOST sets the host label for local sessions (default: hostname).
AGENTBOARD_REMOTE_HOSTS enables remote tmux polling over SSH. Provide a comma-separated list of hosts (e.g., mba,carbon,worm). Remote sessions show live status (working/waiting/permission) via pane content capture over SSH.
AGENTBOARD_REMOTE_POLL_MS, AGENTBOARD_REMOTE_TIMEOUT_MS, and AGENTBOARD_REMOTE_STALE_MS control remote poll cadence, SSH timeout, and stale host cutoff.
AGENTBOARD_REMOTE_SSH_OPTS appends extra SSH options (space-separated).
AGENTBOARD_REMOTE_ALLOW_ATTACH enables interactive terminal attach to remote sessions (input, resize, copy-mode). When false (default), remote sessions are view-only.
AGENTBOARD_REMOTE_ALLOW_CONTROL enables destructive remote session management (create, kill, rename) via the UI. Setting this to true implies REMOTE_ALLOW_ATTACH=true. Kill and rename are restricted to agentboard-managed sessions — externally-discovered remote sessions cannot be killed or renamed even with control enabled.
AGENTBOARD_LOG_WATCH_MODE selects the log detection strategy: watch (default) uses fs.watch for instant file-change detection, poll falls back to periodic directory scanning. Use poll if you experience issues with filesystem notifications (e.g., on network-mounted home directories). On Linux, watch mode automatically includes a 15-second fallback poll since fs.watch({ recursive: true }) has known platform bugs.
Paste text or files directly into the terminal prompt. Desktop clipboard paste and file drops upload device files and insert their paths without pressing Enter. On mobile, Paste opens a dialog with a field for native clipboard paste and Choose files for selecting one or more files. File uploads accept any extension, up to 40 MB per file. Files are stored temporarily on the Agentboard host; uploads are unavailable for SSH sessions.
The mobile dialog works the same over HTTP and HTTPS. Touch and hold in the field to paste, or select Choose files. Either action inserts directly into the existing terminal prompt without submitting it. Automatic clipboard re
暂无开放 Issues,或尚未同步最近议题。