AI代理仪表盘

Prerequisites

Install

Step 1: Install the binary

curl -fsSL https://raw.githubusercontent.com/bjornjee/agent-dashboard/main/install.sh | sh

The installer downloads the binary for your platform from the latest GitHub Release, verifies its SHA256 checksum, and installs it to ~/.local/bin/agent-dashboard. No Go toolchain required.

Or build from source (requires Go 1.26+):

git clone https://github.com/bjornjee/agent-dashboard
cd agent-dashboard
./install.sh --build

Step 2: Register the marketplace and install the plugin

In any Claude Code session, run:

/marketplace add bjornjee/agent-dashboard
/plugin install agent-dashboard@agent-dashboard
/plugin enable agent-dashboard@agent-dashboard

Then restart Claude Code sessions for hooks and skills to take effect.

Uninstall

In any Claude Code session, run /plugin uninstall agent-dashboard@agent-dashboard and /marketplace remove agent-dashboard. Then remove the binary and state:

curl -fsSL https://raw.githubusercontent.com/bjornjee/agent-dashboard/main/uninstall.sh | sh

Or from a repo checkout: make uninstall.

Usage

agent-dashboard

Or press prefix + D if you set up the tmux keybinding. The keys you'll use most:

The full tables — including the diff viewer and search palette keys — are in the keybindings reference.

Optional: tmux keybinding

The included agent-dashboard.tmux script binds prefix + D to switch to a dedicated dashboard session:

```bash

Reload tmux config

tmux source-file ~/.tmux.conf ```

Configuration

The dashboard reads a TOML file at ~/.agent-dashboard/settings.toml — banner, notifications, usage polling, thinking-effort defaults, and the harness picker (claude or codex) all live there. Missing keys fall back to sensible defaults; see settings.example.toml and the settings reference for every key, default, and environment variable.

Codex CLI support

Register the marketplace entry with Codex:

codex plugin marketplace add bjornjee/agent-dashboard

Then enable the plugin by appending the following to ~/.codex/config.toml:

[plugins."agent-dashboard@agent-dashboard"]
enabled = true

Restart Codex sessions and approve the agent-dashboard hooks prompt. Once approved, the dashboard sees Codex sessions just like Claude sessions — same state files, same conversation panel, same cost dashboard. From a repo checkout, make install-codex-adapter performs the registration and prints the config snippet.

Recommended companion plugins

agent-dashboard works best when paired with bjornjee/skills — a plugin of workflow skills (TDD guide, language-specific strict reviewers, refactor cleaner, codex delegation, terminal ops) that the dashboard's session-creation flow expects:

/marketplace add bjornjee/skills
/plugin install skills@bjornjee-skills

Without it, skill-gated session types (feature, fix, chore, refactor, investigate, implement, pr, rca) will not function as intended.

FAQ

Do I need tmux? Yes. agent-dashboard reads live pane content via tmux capture-pane and spawns agent sessions in tmux panes. Without tmux there are no panes to monitor.

Which agents are supported? Claude Code is first-class via the adapter in adapters/claude-code/. Codex CLI is supported directly via the adapter in adapters/codex/. The architecture supports additional backends via the domain.Harness interface.

How do I use codex / gpt-5.x models? Pick codex in the New Agent harness step (TUI wizard or web form), with per-spawn flags from [harness.codex] in ~/.agent-dashboard/settings.toml. Codex sessions appear in the dashboard once the Codex plugin is installed and its hooks approved (see Codex CLI support).

Does this require a paid Claude account? No — it uses whatever Claude Code itself requires (Pro, Max, or API). agent-dashboard does not call the Anthropic API directly; it reads the JSONL transcripts Claude Code writes locally.

Can I use the dashboard without the mobile companion? Yes. The TUI is the primary interface. The PWA is optional and runs separately via make web.

How is this different from a generic tmux session manager? A session manager creates and switches panes. agent-dashboard understands what's running in each pane — it parses the harness's transcripts to detect state (blocked, waiting, running, review, PR, merged), captures plans and Mermaid diagrams, tracks token usage, and integrates the GitHub PR workflow.

Is this related to Claude Code's official UI? No. agent-dashboard is an unofficial third-party plugin. It builds on top of Claude Code's hooks system and JSONL transcripts but is not affiliated with Anthropic.

Does it work on Windows? Native Windows is unsupported — the project targets macOS and Linux because tmux is required. WSL with tmux installed should work but is untested.