Agent View

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.

Built for Claude Code, with support for any custom command.

Supported Platforms

Platform	Architecture	Status
macOS	Apple Silicon (arm64)	✅ Supported
macOS	Intel (x64)	✅ Supported
Linux	arm64	✅ Supported
Linux	x64	✅ Supported
WSL	x64	✅ Supported

---

⭐ If you find this useful, please give it a star to help others discover it!

---

Why Agent View?

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.

Demo

Features

• Multi-Agent Dashboard - View all your AI coding assistant sessions at a glance with real-time status indicators
• Native Notifications - OS notifications (macOS/Linux) when an agent finishes a task or needs your input, powered by Claude Code hooks. They fire even while you're attached to another session or the dashboard is closed, and are suppressed for the session you're currently watching. Toggle in Settings (c).
• 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
• Custom Commands - Besides Claude Code, run any custom command (aider, scripts, plain shells) as a managed session
• 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

Status Detection

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

Installation

Quick Install

curl -fsSL https://raw.githubusercontent.com/frayo44/agent-view/main/install.sh | bash

Manual Install

git clone git@github.com:frayo44/agent-view.git
cd agent-view
bun install
bun run build

Compile Standalone Binary

bun run compile        # Current platform
bun run compile:all    # All platforms (macOS/Linux, x64/arm64)

Usage

Start Agent View

agent-view
# or use the short alias
av

Keyboard Shortcuts

Dashboard:

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)

Create a Session

1. Press n to open the new session dialog
2. Enter the project path (optionally enable git worktree for an isolated branch)
3. Pick Claude Code or a custom command, set options
4. Press Enter to create and attach

Configuration

Create ~/.agent-view/config.json to customize defaults:

{
  "notifications": true,
  "worktree": {
    "defaultBaseBranch": "main",
    "command": "git worktree"
  },
  "shortcuts": [
    {
      "name": "Backend API",
      "tool": "claude",
      "projectPath": "/home/dev/projects/backend-api",
      "groupPath": "work",
      "keybind": "<leader>1"
    },
    {
      "name": "Deploy Shell",
      "tool": "custom",
      "command": "./deploy.sh",
      "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 or custom
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)

Remote Sessions

Manage AI coding sessions running on remote machines (dev boxes, cloud VMs, etc.) from your local Agent View dashboard.

Setup

1. Install av on the remote machine
2. Ensure SSH access is configured (key-based auth recommended)
3. Press Shift+N to create a remote session

Creating Remote Sessions

Press Shift+N to open the remote session wizard:

1. SSH Host - Enter the SSH destination (e.g., user@hostname or an SSH config name)
2. av Path - Path to av binary on remote (default: av)
3. Tool - Claude Code or a custom command
4. Project Path - Working directory on the remote machine
5. Title - Optional session name

Values are remembered for next time.

Requirements

• Bun runtime
• tmux for session management
• Claude Code (or any custom command to run as a session)
• For remote sessions: SSH access to remote host with av installed

Acknowledgments

This project is inspired by agent-deck.

License

MIT