Agentboard offers a web GUI for tmux, optimizing interactions with AI agent text-based user interfaces (TUIs) like Claude and Codex. It simplifies managing complex agent sessions, especially on mobile devices, by providing a unified, accessible workspace. Users can connect from phones or laptops to server-based tmux sessions, streamlining TUI management and ensuring persistent access for AI researchers and developers.

How It Works

This project functions as a web server interfacing with tmux sessions, installable via npm or Bun. It features automatic discovery and matching of AI agent sessions using log patterns for one-click restoration. Mobile users benefit from touch-friendly controls, image paste support, and virtual navigation. Remote access via Tailscale or LAN creates a shared, persistent environment. Session pinning ensures critical agent sessions automatically resume after server reboots or tmux failures.

Quick Start & Requirements

• Installation: npm install -g @gbasin/agentboard or npx @gbasin/agentboard. From source: bun install && bun run dev.
• Prerequisites: tmux, npm or Bun (v1.3.6+ recommended). Tailscale is recommended for remote access.
• Access: Web UI at http://localhost:4040 or http://<your-machine>:4040. Dev server at http://<your-machine>:5173.
• Docs: Persistent deployment guidance in systemd/README.md.

Highlighted Details

• AI TUI Optimization: Out-of-the-box log tracking and session matching for Claude, Codex, Pi.
• Mobile-First Experience: iOS Safari optimized with image paste, touch scrolling, virtual controls.
• Cross-Device Workspace: Connect from phones/laptops to server tmux sessions.
• Session Persistence: Pinning ensures auto-resume after restarts/crashes.
• Desktop Shortcuts: Mac/Windows/Linux shortcuts for session navigation.

Maintenance & Community

The README provides no explicit details on contributors, sponsorships, or community channels.

Licensing & Compatibility

The specific open-source license is not stated. Verification is needed for commercial use or closed-source integration.

Limitations & Caveats

Bun upgrade to v1.3.6+ is required to fix "open terminal failed: not a terminal" errors. Full remote control is read-only in the current MVP.