tony1223 / better-agent-terminal

Better Agent Terminal **A cross-platform terminal aggregator with multi-workspace support and Claude Code integration** Download Latest Release --- Screenshot --- Features Workspace Management • **Multi-Workspace** — Organize terminals by project folders • **Drag & Drop** — Reorder workspaces freely • **Groups** — Categorize workspaces with filter dropdown • **Detachable Windows** — Pop out workspaces to separate windows, auto-reattach on restart • **Per-Workspace Env Vars** — Configure environment variables per workspace • **Activity Indicators** — See which workspaces have running terminals • **Double-click to rename**, right-click context menu for all actions Terminal • **Google Meet-style layout** — 70% main panel + 30% thumbnail bar • **Multiple terminals per workspace** — xterm.js with full Unicode/CJK support • **Tab navigation** — Terminal / Files / Git views • **File browser** — Search, navigate, preview files with syntax highlighting • **Git integration** — Diff viewer, branch display, untracked files, GitHub link detection • **Snippet manager** — Save, organize, and paste code snippets Claude Code Agent • **Built-in Claude Code** via SDK — no separate terminal needed • **Message streaming** with extended thinking (collapsible) • **Permission-based tool execution** with bypass mode • **Active tasks bar** — See running operations with elapsed time • **Session resume** — Persist and resume conversations across restarts • **Rest/Wake sessions** — Pause and resume agent sessions from context menu • **Statusline** — Token usage, cost, context window %, model, git branch, duration • **Prompt history** — View and copy all user prompts from statusline • **Image attachment** — Drag-drop or button (max 5 images) • **Clickable URLs** — Markdown links and bare URLs open in default browser • **Clickable file paths** — Preview files with syntax highlighting, search (Ctrl+F) • **Ctrl+P file picker** — Search and attach files to context --- Keyboard Shortcuts | Shortcut | Action | |---|---| | / | File picker (search & attach files) | | | Switch between Terminal and Agent mode | | | Send message | | | Insert newline (multiline input) | | | Stop streaming / close modal | | | Copy selected text | | | Paste from clipboard | | | Copy (if selected) or Paste | Slash Commands | Command | Description | |---|---| | | Resume a previous Claude session | | | Switch between available models | --- Quick Start Option 1: Download Release Download from Releases for your platform: | Platform | Format | |---|---| | Windows | NSIS installer, | | macOS | (universal binary) | | Linux | | **macOS DMG installation:** • Download the file from Releases • Double-click the to mount it • Drag **Better Agent Terminal** into the **Applications** folder • On first launch, macOS may block the app — go to **System Settings > Privacy & Security**, scroll down and click **Open Anyway** • Make sure Claude Code CLI is installed ( ) Option 2: Build from Source **Prerequisites:** • Node.js 18+ • Claude Code CLI installed and authenticated **Development mode:** **Build for production:** macOS Build Notes Native dependencies ( , ) require Xcode Command Line Tools: Then: --- Architecture Tech Stack • **Frontend:** React 18 + TypeScript • **Terminal:** xterm.js + node-pty • **Framework:** Electron 28 • **AI:** @anthropic-ai/claude-agent-sdk • **Build:** Vite + electron-builder • **Storage:** better-sqlite3 --- Configuration Workspaces and settings are saved to: | Platform | Path | |---|---| | Windows | | | macOS | | | Linux | | --- Release Version Format Version follows: Example: = 2025-12-19 09:15:38 Automated Release (GitHub Actions) Push a tag to trigger builds for all platforms: --- License MIT License - see LICENSE for details. --- Author **TonyQ** - @tony1223 Contributors • **lmanchu** - @lmanchu - macOS/Linux support, workspace roles • **bluewings1211** - @bluewings1211 - Shift+Enter newline, preserve workspace state, font settings --- Built with Claude Code