百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
A

agentboard

> 编程语言
开源

针对 AI 代理 TUIs 优化的 tmux Web GUI,支持 iOS safari 和 mac 系统带有键盘快捷键

399 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

针对 AI 代理 TUIs 优化的 tmux Web GUI,支持 iOS safari 和 mac 系统带有键盘快捷键

Agentboard

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.

  • iOS Safari mobile experience with:
    • Paste support (including images)
    • Touch scrolling, tap-to-click, and long-press selection in fullscreen Claude Code sessions
    • Mobile-friendly copy prompts when browser clipboard writes need a user gesture
    • Virtual arrow keys / d-pad
    • Quick keys toolbar (ctrl, esc, etc.)
  • Claude Code fullscreen renderer support by default, with mouse scrolling, click handling, in-app selection, and clipboard forwarding through the browser terminal
  • Out-of-the-box log tracking and matching for Claude, Codex, and Pi — auto-matches sessions to active tmux windows, with one-click Wake for Hibernating and History sessions.
  • Shows the last user prompt for each session, so you can remember what each agent is working on
  • Hibernate sessions to close their tmux window while keeping them visible across restarts for manual Wake

How It Works

…
  • Session discovery — polls local tmux windows and (optionally) remote hosts over SSH
  • Status inference — reads pane content and Claude/Codex JSONL logs to determine if each agent is working, waiting for input, or asking for permission
  • Live terminal — streams I/O through the server so you can interact with any session from any device
  • Hibernating and History sessions — keeps dormant agent sessions in the sidebar and wakes them on demand; startup does not auto-wake dormant sessions

Desktop

Terminal Sessions Hibernating

Mobile

Terminal Controls

Requirements

  • tmux (brew install tmux / apt install tmux)
  • Tailscale (recommended) or any network path to your machine

Install

Homebrew

bash
brew tap gbasin/tap
brew install agentboard
agentboard

npm

bash
npm install -g @gbasin/agentboard
agentboard

Or run directly:

bash
npx @gbasin/agentboard

Then open http://localhost:4040 (or http://:4040 from another device).

For persistent deployment, see systemd/README.md (Linux) or launchd/README.md (macOS).

From source

Requires Bun 1.3.14+ (see Troubleshooting).

bash
bun install
bun run dev

Open http://:5173 (Vite dev server). In production, UI is served from the backend port (default 4040).

Production:

bash
bun run build
bun run start

For persistent deployment, see systemd/README.md (Linux) or launchd/README.md (macOS).

Dependency Risk Scanner

Use the built-in scanner to report security and maintenance risk for direct dependencies:

bash
bun run deps:risk

Machine-readable output:

bash
bun run deps:risk:json

Policy:

  • Security risk comes from bun audit --json findings and is aggregated by severity (low, moderate, high, critical).
  • Maintenance risk comes from bun outdated and classifies version lag as major, minor, or patch behind latest.
  • Local default threshold is high (high + critical fail).
  • CI enforces security threshold breaches at 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):

bash
bun run deps:risk -- --threshold moderate

Keyboard Shortcuts

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

Environment

…

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.0 on 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· 8 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

TypeScript

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言