by tony1223
Multi-workspace terminal aggregator with Claude Code AI integration
# Add to your Claude Code skills
git clone https://github.com/tony1223/better-agent-terminal
A cross-platform terminal aggregator with multi-workspace support and built-in AI agent integration
Manage multiple project terminals in one window, with built-in Claude Code and Codex agent panels, file browser, git viewer, snippet manager, and remote access — all in a single Electron app.
Claude Code Agent Panel — Built-in AI agent with permission controls, status line, and streaming output
Terminal — Run persistent terminals alongside your agent for long-running commands and monitoring
File Browser — Browse and preview project files without leaving the app
Git Viewer — View commit history and diffs at a glance
No comments yet. Be the first to share your thoughts!
.md files in a dedicated right sidebar panel with live file watching and right-click context menuA configurable status bar at the bottom of the agent panel, with 15 items across three zones (left / center / right):
| Item | Description | |---|---| | Session ID | First 8 chars of SDK session ID (click to resume a past session) | | Git Branch | Current git branch name | | Tokens | Total input + output token count (click for context breakdown) | | Turns | Number of conversation turns | | Duration | Session duration | | Context % | Percentage of context window used (color-coded) | | Cost | Total session cost in USD | | Workspace | Current workspace name | | 5h Usage / Reset | 5-hour API rate limit usage and reset countdown | | 7d Usage / Reset | 7-day API rate limit usage and reset countdown | | Max Output | Maximum output tokens for current model | | Cache Eff. | Cache read efficiency percentage (click for cache history with per-turn cost breakdown) | | Prompts | Link to view prompt history |
Items can be reordered, colored, and toggled on/off via a drag-and-drop template editor in Settings.
/switch to manage and switch between multiple Claude accountsOptional alternate agent backend powered by @openai/codex-sdk. Pick Codex Agent (or Codex Agent (worktree)) from the agent preset list when creating a terminal.
read-only, workspace-write, or danger-full-accessuntrusted, on-request, or never (auto)~/.codex/sessions/ are auto-indexed; resume hits a local cache so re-opening a thread is fast even with months of historyplan items render as approvable blocks in the panelHidden behind BAT_DEBUG=1. Talks directly to the OpenAI Responses API via @ai-sdk/openai, without the Codex CLI. Useful for testing tool flows against a raw model. Not recommended for daily use — Codex Agent is the supported path.
| Shortcut | Action |
|---|---|
| Ctrl+`` / `Cmd+ `` | Toggle between Agent terminal and first regular terminal | |Ctrl+←/→/Cmd+←/→| Cycle workspace tabs (Terminal / Files / Git) | |Ctrl+↑/↓/Cmd+↑/↓| Switch to previous / next workspace | |Ctrl+P/Cmd+P| File picker (search & attach files to agent context) | |Ctrl+N/Cmd+N| Open new window | |Shift+Tab| Switch between Terminal and Agent mode | |Enter| Send message | |Shift+Enter| Insert newline (multiline input) | |Escape| Stop streaming / close modal | |Ctrl+Shift+C| Copy selected text | |Ctrl+Shift+V| Paste from clipboard | |Right-click` | Copy (if text selected) or Paste |
| Command | Description |
|---|---|
| /resume | Resume a previous Claude session from history |
| /model | Switch between available Claude models |
| /new / /clear | Reset session (clear conversation, fresh start) |
| /abort | Stop the current agent session immediately |
| /snippet | Show snippets to Claude for management |
| /switch | Switch between Claude accounts |
| /login | Sign in to Claude (switch a