Agent Console

Agent Console is a local terminal dashboard for Codex, Claude Code, and pi. It discovers recent sessions, shows their current state, resumes the native agent UI, and keeps same-workspace shells beside each agent.

Website · Downloads · Contact

Twenty sessions across seven workspaces, every provider in one list. A session stops for an approval, the dashboard raises an alert, and a jumps straight to it. s opens a shell in that session's own directory, beside the agent.

What it provides

• Codex, Claude Code, and pi sessions grouped by workspace
• Working, waiting, idle, and failed status at a glance
• Same-provider progress summaries
• Native agent resume instead of a replacement chat UI
• Multiple persistent shell panes in the agent workspace
• Search, archive/restore, alerts, and mouse scrolling

Architecture

Requirements

• macOS, Linux, or Windows 10+
• codex, claude, and/or pi available on PATH
• A terminal with ANSI and mouse support

Install

Download the package for your platform from GitHub Releases:

• macOS Intel: agent-console-v<version>-x86_64-apple-darwin.tar.gz
• macOS Apple Silicon: agent-console-v<version>-aarch64-apple-darwin.tar.gz
• Linux Intel: agent-console-v<version>-x86_64-unknown-linux-gnu.tar.gz
• Linux ARM64: agent-console-v<version>-aarch64-unknown-linux-gnu.tar.gz
• Windows Intel: agent-console-v<version>-x86_64-pc-windows-msvc.zip

With a Rust toolchain installed, you can instead build and install the published crate:

cargo install agent-console

From a source checkout, make install builds the release binary and installs it to ~/.local/bin using an atomic rename:

make install

Set PREFIX to install elsewhere, for example make install PREFIX=/usr/local.

Extract the archive and place agent-console (agent-console.exe on Windows) in a directory on PATH. On macOS, install and upgrade it with an atomic rename so the kernel never reuses a cached signature from the old inode:

sudo install -m 755 ./agent-console /usr/local/bin/agent-console.new
sudo mv -f /usr/local/bin/agent-console.new /usr/local/bin/agent-console

Do not copy directly over a running or previously launched signed binary on macOS. Agent Console is a terminal program; launch it from your terminal rather than Finder.

Published macOS binaries are signed with Developer ID, use the hardened runtime, and are accepted by Apple's notarization service. Because Apple cannot staple a ticket to a standalone executable or tar.gz, macOS may perform an online notarization lookup on first launch.

Start

agent-console

agent-console --version and agent-console --help print metadata without opening the dashboard.

Check provider and terminal prerequisites without opening the dashboard:

agent-console doctor

Browser access

agent-console serves the web UI while the dashboard runs -- one process, one set of sessions, no second command:

 web  http://127.0.0.1:7878/?token=<token>   random token in the URL (set --auth for HTTP Basic)