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 [email protected]: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) |
Manage AI coding sessions running on remote machines (dev boxes, cloud VMs, etc.) from your local Agent View dashboard.
- Install
avon the remote machine - Ensure SSH access is configured (key-based auth recommended)
- Press
Shift+Nto create a remote session
Press Shift+N to open the remote session wizard:
- SSH Host - Enter the SSH destination (e.g.,
user@hostnameor an SSH config name) - av Path - Path to
avbinary on remote (default:av) - Tool - Select the AI tool to use
- Project Path - Working directory on the remote machine
- Title - Optional session name
Values are remembered for next time.
- Bun runtime
- tmux for session management
- At least one AI coding tool installed (claude, gemini, opencode, etc.)
- For remote sessions: SSH access to remote host with
avinstalled
This project is inspired by agent-deck.
MIT
