Show HN: Agent Console – A Local Dashboard for Codex and Claude Code

Agent Console, a local terminal dashboard for Codex and Claude Code, is now available on GitHub. The tool groups sessions by workspace, displays status at a glance, and allows native agent resume with persistent shell panes, supporting macOS, Linux, and Windows 10+.

Agent Console is a local terminal dashboard for Codex and Claude Code. It discovers recent sessions, shows their current state, resumes the native agent UI, and keeps same-workspace shells beside each agent. - Codex and Claude Code 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 - macOS, Linux, or Windows 10+ codex and/or claude available on PATH - A terminal with ANSI and mouse support Download the package for your platform from GitHub Releases https://github.com/buhuipao/agent-console/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 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. 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 Use ~/.config/agent-console/config.toml when a provider needs a wrapper, proxy, environment variables, or fixed arguments: providers codex = "proxychains4", "codex" claude = "env", "HTTPS PROXY=http://127.0.0.1:7890", "claude" Missing entries use codex or claude directly. The configured command is also used by that provider's isolated summarizer. Set AGENT CONSOLE CONFIG=/path/to/config.toml to use another file. Limit Agent Console to a subset of providers with a comma-separated AGENT CONSOLE PROVIDERS : AGENT CONSOLE PROVIDERS=codex agent-console Omitted providers are not scanned and are left out of doctor . An unset or unrecognized value keeps every provider enabled. Dashboard: | Key | Action | |---|---| ↑ / ↓ , j / k | Select a session | Enter | Open the selected agent | s | Open a shell | n | Create a session | / | Search sessions as you type | x | Archive or restore | a | Jump to the next alert | ? | Show all active controls | q , Esc | Quit | When another Agent Console owns the selected live session, the message shown on screen offers t for an intentional force takeover. Inside a session workspace: | Key | Action | |---|---| Ctrl-O | Cycle Agent → Shell → Sessions focus | Ctrl-\ | Create and focus a shell | Ctrl-N | Focus the next shell while Shell has focus | Ctrl-X | Close the focused shell | Ctrl-Q | Return to the dashboard | Ctrl- | Jump to the session behind an alert | With the Sessions list focused: | Key | Action | |---|---| ↑ / ↓ , j / k | Select a session | Enter , Ctrl-O | Open/resume and focus its agent | / | Search sessions as you type | a | Jump to the next unread alert | ? | Show the Workspace key bindings | n | Create a session in the selected workspace | s | Create and focus a shell | x | Archive or restore the session | h | Maximize and focus the agent | m | Maximize and focus the last selected shell | + / | Grow or shrink the shell area | y | Copy the latest shell command output | 1 … 9 | Focus a numbered shell | After h or m , use Ctrl-O until focus returns to Sessions; the normal split layout is restored automatically. Agent and shell viewport controls: | Input | Action | |---|---| Shift-PageUp / Shift-PageDown | Scroll one viewport | Shift-End | Return to live output | | Mouse wheel | Scroll the pane under the pointer | | Drag | Select and copy immediately; do not press Cmd-C afterward | | Terminal bypass modifier + drag | Use native selection, then copy normally Option -drag in iTerm2; commonly Shift -drag elsewhere | The new-session dialog uses Shift-Tab to switch between provider and workspace, arrows or h / l to choose a provider, normal cursor movement and editing in the workspace path, Up/Down to choose a directory completion, Tab to accept it, Enter to start, and Esc to cancel. Search filters live on both Dashboard and the focused Sessions list; Enter keeps the filter and Esc restores it. It matches aliases, provider session names and generated titles, first/latest prompts, conversation summaries, Claude tags and PR/MR metadata, workspace names and paths, branches, provider session IDs, providers, statuses, and active/archived state. Agent Console does not reserve Ctrl-T , Ctrl-Enter , Esc , function keys, or unrelated Ctrl combinations from the focused Codex, Claude, or shell process. Press ? for the authoritative context-sensitive key list, including any bindings overridden in the configuration file. - Summaries use the session's own provider and run outside the coding conversation. Disable them with AGENT CONSOLE SUMMARIZER=off . - Agent Console can reconnect only to processes it launched and owns. Existing sessions from other terminal tabs are resumed from their saved transcript. - Managed Codex sessions run with --no-alt-screen , allowing the Workspace pane to retain and scroll the transcript in every Codex state. - Running Codex fork subagents are identified from transcript metadata and disappear from Sessions when their final task completes or aborts. - Each managed pane retains up to 2,000 scrollback rows. The separate 128 KiB daemon replay tail is a reconnect transport bound; crossing it does not stop the process or discard Codex's retained viewport rows. - Local state is stored under ~/.local/state/agent-console by default. - Detailed behavior and constraints are documented in SPECS.md /buhuipao/agent-console/blob/main/SPECS.md . cargo build --locked cargo test --locked --all-targets cargo clippy --locked --all-targets -- -D warnings Provider compatibility details are in docs/compatibility.md /buhuipao/agent-console/blob/main/docs/compatibility.md . Licensed under either of Apache License, Version 2.0 /buhuipao/agent-console/blob/main/LICENSE-APACHE or MIT license /buhuipao/agent-console/blob/main/LICENSE-MIT at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.