A lightweight terminal-based agent orchestrator for managing multiple AI coding assistants.
Run multiple AI coding agents in parallel and manage them from a single dashboard. Agent View is a lightweight tmux session manager built for AI-assisted development workflows - monitor agent status in real-time, get notifications when agents finish or need input, and seamlessly switch between sessions.
Works with Claude Code, Gemini CLI, OpenCode, Codex CLI, and any custom AI coding tool.
| Platform | Architecture | Status |
|---|---|---|
| macOS | Apple Silicon (arm64) | ✅ Supported |
| macOS | Intel (x64) | ✅ Supported |
| Linux | arm64 | ✅ Supported |
| Linux | x64 | ✅ Supported |
| WSL | x64 | ✅ Supported |
When working with AI coding agents, you often need to run multiple agents on different tasks - one refactoring a module, another writing tests, a third exploring a bug. Agent View lets you orchestrate all of them from one place instead of juggling terminal tabs. It's the missing multi-agent management layer for your AI-assisted development workflow.
- Multi-Agent Dashboard - View all your AI coding assistant sessions at a glance with real-time status indicators
- Smart Notifications - Get notified when an agent finishes a task or needs your input, so you can context-switch efficiently
- Session Management - Create, stop, restart, and delete coding agent sessions with keyboard shortcuts
- Git Worktree Integration - Automatically create isolated git worktrees for each agent session, keeping your branches clean
- Tool Agnostic - Works as a Claude Code manager, Gemini CLI orchestrator, OpenCode dashboard, or with any custom AI tool
- Keyboard-First - Fully navigable terminal UI with keyboard shortcuts for maximum productivity
- Session Groups - Organize sessions into groups by project or workflow
- Persistent State - Sessions survive terminal restarts and system reboots via tmux
Agent View monitors your sessions and shows real-time status indicators:
| Status | Symbol | What It Means |
|---|---|---|
| Running | ● green | Agent is actively working |
| Waiting | ◐ yellow | Needs your input |
| Idle | ○ gray | Ready for commands |
| Stopped | ◻ gray | Session was stopped |
| Error | ✗ red | Something went wrong |
curl -fsSL https://raw.githubusercontent.com/frayo44/agent-view/main/install.sh | bashgit clone git@github.com:frayo44/agent-view.git
cd agent-view
bun install
bun run buildbun run compile # Current platform
bun run compile:all # All platforms (macOS/Linux, x64/arm64)agent-view
# or use the short alias
avDashboard:
| Key | Action |
|---|---|
n | Create new session |
Enter | Attach to session / toggle group |
↑/k | Navigate up |
↓/j | Navigate down |
→/l | Expand group (or attach to session) |
←/h | Collapse group |
d | Delete session or group |
r | Restart session |
R | Rename session or group |
f | Fork session |
F | Fork session with worktree |
s | Open shortcuts dialog |
g | Create new group |
m | Move session to group |
1-9 | Jump to group by number |
Ctrl+K | Open command palette |
? | Show help |
q | Quit |
Inside attached session:
| Key | Action |
|---|---|
Ctrl+K | Detach and open command palette |
Ctrl+T | Toggle terminal pane (open/close) |
Ctrl+O | Toggle focus between panes |
Ctrl+Q | Detach (return to dashboard) |
- Press
nto open the new session dialog - Select your AI tool (Claude, Gemini, OpenCode, etc.)
- Enter the project path
- Optionally enable git worktree for an isolated branch
- Press
Enterto create and attach
Create ~/.agent-view/config.json to customize defaults:
{
"defaultTool": "claude",
"worktree": {
"defaultBaseBranch": "main",
"command": "git worktree"
},
"shortcuts": [
{
"name": "Backend API",
"tool": "claude",
"projectPath": "/home/dev/projects/backend-api",
"groupPath": "work",
"keybind": "<leader>1"
},
{
"name": "Frontend App",
"tool": "gemini",
"projectPath": "/home/dev/projects/frontend-app",
"groupPath": "work",
"keybind": "<leader>2"
}
]
}Shortcuts allow quick session creation from pre-configured templates. Press s to open the shortcuts dialog, or use direct keybinds (e.g., \1 for <leader>1).
| Shortcut Field | Required | Description |
|---|---|---|
name | Yes | Display name and session title |
tool | Yes | claude, gemini, opencode, codex, custom, shell |
projectPath | Yes | Working directory for the session |
groupPath | Yes | Target group (created automatically if missing) |
keybind | No | Direct keybind, e.g. "<leader>1", "ctrl+1" |
command | No | Custom command (required when tool is custom) |
- Bun runtime
- tmux for session management
- At least one AI coding tool installed (claude, gemini, opencode, etc.)
This project is inspired by agent-deck.
MIT