247420/agentgui

see it running

A non-interactive preview of agentgui on a typical machine.

Gmail-inspired layout · Claude Code · real project · real output

localhost:3000/gm/
connected
You
Make the GUI as Gmail-like as achievable. Add a nav rail, move search to the header, style conversation rows like email list items.
10:42 AM
Read static/css/main.css ✓ ok
read 620 lines · sidebar · main-panel · conversation-item · input-card
Read static/css/brand-bible.css ✓ ok
read 449 lines · design tokens · panel vars · typography
Write static/css/gmail-skin.css ✓ written
363 lines · grid layout · nav-rail · gm-* tokens · pill rows · search bar
Edit static/index.html ✓ updated
added .nav-rail · .header-search-wrap · loaded gmail-skin.css
claude-code Claude Code · sonnet-4-7
Done. Here's what changed:

Three-column grid — icon nav rail (72px) → conversation list (280px) → main panel
Nav rail with Compose FAB + Chats / Archived / Tools icons, pill hover/active states
Header search bar — prominent pill input spanning the header, syncs to sidebar search
Conversation rows — bold title, muted meta + timestamp, pill hover highlight in Google blue
Input card — rounded corners, elevation shadow, Google-blue send pill
Soft borders#e0e0e0 hairlines + drop shadows instead of brand-bible outlines
10:43 AM
Claude Code is thinking... Cancel
message agentgui...
claude-code
claude-sonnet-4-7
Send

what you get

Real-time streaming
Watch tokens arrive live. Tool calls, thinking blocks, and results rendered as they happen via WebSocket.
🤖
14 supported agents
Claude Code, Gemini CLI, OpenCode, Kilo, Codex, Goose and more. Auto-detected from PATH at startup.
🗂️
Persistent SQLite history
Every conversation, session, and event stored locally in ~/.gmgui/data.db. Resume any conversation.
🎨
Gmail-inspired UI
Icon nav rail, header search, email-row conversation list, elevated input card. Light and dark modes.
🔄
Queue & steer
Queue messages while the agent is running. Steer mid-session with a single click — no need to wait.
🧩
Plugin system
Server-side plugins for auth, tools, workflow and more. Hot-reload in watch mode. Zero restart required.

get started

$ npx agentgui

Requires Node.js 18+. Opens on http://localhost:3000/gm/ — no account, no cloud, runs entirely local.