{"slug": "show-hn-agent-console-a-local-dashboard-for-codex-and-claude-code", "title": "Show HN: Agent Console – A Local Dashboard for Codex and Claude Code", "summary": "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+.", "body_md": "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.\n\n- Codex and Claude Code sessions grouped by workspace\n- Working, waiting, idle, and failed status at a glance\n- Same-provider progress summaries\n- Native agent resume instead of a replacement chat UI\n- Multiple persistent shell panes in the agent workspace\n- Search, archive/restore, alerts, and mouse scrolling\n\n- macOS, Linux, or Windows 10+\n`codex`\n\nand/or`claude`\n\navailable on`PATH`\n\n- A terminal with ANSI and mouse support\n\nDownload the package for your platform from\n[GitHub Releases](https://github.com/buhuipao/agent-console/releases):\n\n- macOS Intel:\n`agent-console-v<version>-x86_64-apple-darwin.tar.gz`\n\n- macOS Apple Silicon:\n`agent-console-v<version>-aarch64-apple-darwin.tar.gz`\n\n- Linux Intel:\n`agent-console-v<version>-x86_64-unknown-linux-gnu.tar.gz`\n\n- Linux ARM64:\n`agent-console-v<version>-aarch64-unknown-linux-gnu.tar.gz`\n\n- Windows Intel:\n`agent-console-v<version>-x86_64-pc-windows-msvc.zip`\n\nExtract the archive and place `agent-console`\n\n(`agent-console.exe`\n\non Windows)\nin a directory on `PATH`\n\n. On macOS, install and upgrade it with an atomic\nrename so the kernel never reuses a cached signature from the old inode:\n\n```\nsudo install -m 755 ./agent-console /usr/local/bin/agent-console.new\nsudo mv -f /usr/local/bin/agent-console.new /usr/local/bin/agent-console\n```\n\nDo 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.\n\nPublished macOS binaries are signed with Developer ID, use the hardened\nruntime, and are accepted by Apple's notarization service. Because Apple cannot\nstaple a ticket to a standalone executable or `tar.gz`\n\n, macOS may perform an\nonline notarization lookup on first launch.\n\n```\nagent-console\n```\n\n`agent-console --version`\n\nand `agent-console --help`\n\nprint metadata without\nopening the dashboard.\n\nCheck provider and terminal prerequisites without opening the dashboard:\n\n```\nagent-console doctor\n```\n\nUse `~/.config/agent-console/config.toml`\n\nwhen a provider needs a wrapper,\nproxy, environment variables, or fixed arguments:\n\n```\n[providers]\ncodex = [\"proxychains4\", \"codex\"]\nclaude = [\"env\", \"HTTPS_PROXY=http://127.0.0.1:7890\", \"claude\"]\n```\n\nMissing entries use `codex`\n\nor `claude`\n\ndirectly. The configured command is\nalso used by that provider's isolated summarizer. Set\n`AGENT_CONSOLE_CONFIG=/path/to/config.toml`\n\nto use another file.\n\nLimit Agent Console to a subset of providers with a comma-separated\n`AGENT_CONSOLE_PROVIDERS`\n\n:\n\n```\nAGENT_CONSOLE_PROVIDERS=codex agent-console\n```\n\nOmitted providers are not scanned and are left out of `doctor`\n\n. An unset or\nunrecognized value keeps every provider enabled.\n\nDashboard:\n\n| Key | Action |\n|---|---|\n`↑` / `↓` , `j` / `k` |\nSelect a session |\n`Enter` |\nOpen the selected agent |\n`s` |\nOpen a shell |\n`n` |\nCreate a session |\n`/` |\nSearch sessions as you type |\n`x` |\nArchive or restore |\n`a` |\nJump to the next alert |\n`?` |\nShow all active controls |\n`q` , `Esc` |\nQuit |\n\nWhen another Agent Console owns the selected live session, the message shown\non screen offers `t`\n\nfor an intentional force takeover.\n\nInside a session workspace:\n\n| Key | Action |\n|---|---|\n`Ctrl-O` |\nCycle Agent → Shell → Sessions focus |\n`Ctrl-\\` |\nCreate and focus a shell |\n`Ctrl-N` |\nFocus the next shell while Shell has focus |\n`Ctrl-X` |\nClose the focused shell |\n`Ctrl-Q` |\nReturn to the dashboard |\n`Ctrl-]` |\nJump to the session behind an alert |\n\nWith the Sessions list focused:\n\n| Key | Action |\n|---|---|\n`↑` / `↓` , `j` / `k` |\nSelect a session |\n`Enter` , `Ctrl-O` |\nOpen/resume and focus its agent |\n`/` |\nSearch sessions as you type |\n`a` |\nJump to the next unread alert |\n`?` |\nShow the Workspace key bindings |\n`n` |\nCreate a session in the selected workspace |\n`s` |\nCreate and focus a shell |\n`x` |\nArchive or restore the session |\n`h` |\nMaximize and focus the agent |\n`m` |\nMaximize and focus the last selected shell |\n`+` / `_` |\nGrow or shrink the shell area |\n`y` |\nCopy the latest shell command output |\n`1` … `9` |\nFocus a numbered shell |\n\nAfter `h`\n\nor `m`\n\n, use `Ctrl-O`\n\nuntil focus returns to Sessions; the normal split\nlayout is restored automatically.\n\nAgent and shell viewport controls:\n\n| Input | Action |\n|---|---|\n`Shift-PageUp` / `Shift-PageDown` |\nScroll one viewport |\n`Shift-End` |\nReturn to live output |\n| Mouse wheel | Scroll the pane under the pointer |\n| Drag | Select and copy immediately; do not press `Cmd-C` afterward |\n| Terminal bypass modifier + drag | Use native selection, then copy normally (`Option` -drag in iTerm2; commonly `Shift` -drag elsewhere) |\n\nThe new-session dialog uses `Shift-Tab`\n\nto switch between provider and\nworkspace, arrows (or `h`\n\n/ `l`\n\n) to choose a provider, normal cursor movement\nand editing in the workspace path, Up/Down to choose a directory completion,\n`Tab`\n\nto accept it, `Enter`\n\nto start, and `Esc`\n\nto cancel. Search filters live\non both Dashboard and the focused Sessions list; `Enter`\n\nkeeps the filter and\n`Esc`\n\nrestores it. It matches aliases, provider session names and generated\ntitles, first/latest prompts, conversation summaries, Claude tags and PR/MR\nmetadata, workspace names and paths, branches, provider session IDs, providers,\nstatuses, and active/archived state.\n\nAgent Console does not reserve `Ctrl-T`\n\n, `Ctrl-Enter`\n\n, `Esc`\n\n, function keys, or\nunrelated Ctrl combinations from the focused Codex, Claude, or shell process.\nPress `?`\n\nfor the authoritative context-sensitive key list, including any\nbindings overridden in the configuration file.\n\n- Summaries use the session's own provider and run outside the coding\nconversation. Disable them with\n`AGENT_CONSOLE_SUMMARIZER=off`\n\n. - Agent Console can reconnect only to processes it launched and owns. Existing sessions from other terminal tabs are resumed from their saved transcript.\n- Managed Codex sessions run with\n`--no-alt-screen`\n\n, 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.\n- 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.\n- Local state is stored under\n`~/.local/state/agent-console`\n\nby default. - Detailed behavior and constraints are documented in\n[SPECS.md](/buhuipao/agent-console/blob/main/SPECS.md).\n\n```\ncargo build --locked\ncargo test --locked --all-targets\ncargo clippy --locked --all-targets -- -D warnings\n```\n\nProvider compatibility details are in\n[docs/compatibility.md](/buhuipao/agent-console/blob/main/docs/compatibility.md).\n\nLicensed under either of [Apache License, Version 2.0](/buhuipao/agent-console/blob/main/LICENSE-APACHE) or\n[MIT license](/buhuipao/agent-console/blob/main/LICENSE-MIT) at your option.\n\nUnless 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.", "url": "https://wpnews.pro/news/show-hn-agent-console-a-local-dashboard-for-codex-and-claude-code", "canonical_source": "https://github.com/buhuipao/agent-console", "published_at": "2026-07-27 09:55:30+00:00", "updated_at": "2026-07-27 10:23:02.535249+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools"], "entities": ["Agent Console", "Codex", "Claude Code", "GitHub"], "alternates": {"html": "https://wpnews.pro/news/show-hn-agent-console-a-local-dashboard-for-codex-and-claude-code", "markdown": "https://wpnews.pro/news/show-hn-agent-console-a-local-dashboard-for-codex-and-claude-code.md", "text": "https://wpnews.pro/news/show-hn-agent-console-a-local-dashboard-for-codex-and-claude-code.txt", "jsonld": "https://wpnews.pro/news/show-hn-agent-console-a-local-dashboard-for-codex-and-claude-code.jsonld"}}