English | 简体中文
Agent status timeline pane for herdr.
Real-time visualization of agent tasks across all workspaces. Track when agents start working, get blocked, or go idle.
- Real-time agent task timeline (working/blocked states)
- Task aggregation — one entry per agent, deduplicated
- Configurable columns (show/hide any column)
- Session ID tracking
- Horizontal split (bottom) and vertical split (right) modes
- 7-day timeline data retention
- Multi-workspace agent tracking
herdr plugin install 0x5c0f/herdr-insight --yesgit clone https://github.com/0x5c0f/herdr-insight.git
cd herdr-insight
make installgit clone https://github.com/0x5c0f/herdr-insight.git
cd herdr-insight
make link# Download latest release
make download
# Or install from GitHub (auto-detects: cargo build or download)
make installAdd to ~/.config/herdr/config.toml:
# Horizontal split (bottom)
[[keys.command]]
key = "prefix+t"
type = "plugin_action"
command = "herdr-insight.open-timeline-down"
# Vertical split (right)
[[keys.command]]
key = "prefix+shift+t"
type = "plugin_action"
command = "herdr-insight.open-timeline-right"# Open timeline (default split direction)
herdr plugin pane open --plugin herdr-insight --entrypoint timeline
# Open with specific direction
herdr plugin pane open --plugin herdr-insight --entrypoint timeline --direction down
herdr plugin pane open --plugin herdr-insight --entrypoint timeline --direction right
# Invoke actions directly
herdr plugin action invoke herdr-insight.open-timeline-down
herdr plugin action invoke herdr-insight.open-timeline-right| Key | Action |
|---|---|
q / Esc |
Close timeline |
↑ / k |
Scroll up (newer tasks) |
↓ / j |
Scroll down (older tasks) |
Create config file at ~/.config/herdr/plugins/config/herdr-insight/config.toml:
make config-init[columns]
time = true # Timestamp
state = true # Status icon (● working / ▲ blocked)
agent = true # Agent name
pane = true # Pane ID [wX:pY]
status = true # Status text (working/blocked)
duration = true # Current task duration
session = true # Full session ID| Column | Default | Description |
|---|---|---|
time |
true |
Show timestamp |
state |
true |
Show status icon |
agent |
true |
Show agent name |
pane |
true |
Show pane ID |
status |
true |
Show status text |
duration |
true |
Show current task duration |
session |
true |
Show full session ID |
- Rust toolchain (cargo)
- herdr >= 0.7.0
make build # Build release binary (cargo or download)
make build-static # Build static binary (musl, Linux only)
make release # Build release tarballs
make release-upload # Upload to GitHub Releasesmake help # Show all available targets
make build # Build release binary
make download # Download pre-compiled binary
make build-static # Build static binary (musl)
make release # Build release tarballs
make release-upload Upload release to GitHub
make link # Build and link to herdr (local dev)
make unlink # Unlink from herdr
make install # Install from GitHub
make uninstall # Uninstall plugin
make update # Reinstall from GitHub
make test # Run tests
make lint # Run rustfmt + clippy
make check # Run lint + test
make clean # Clean build artifacts
make open # Open timeline panel
make info # Show plugin registration info
make config # Show config directory path
make state # Show state directory path
make logs # Show plugin logs
make config-init # Create default config file
Multi-crate Rust workspace:
herdr-insight/
├── crates/
│ ├── common/ # Shared types (AgentState, AgentSnapshot, etc.)
│ ├── domain/ # Business logic (poller, transitions)
│ ├── infra/ # Infrastructure (herdr CLI, persistence)
│ ├── tui/ # Timeline TUI (render, state, config)
│ └── app/ # Binary entry point
└── herdr-plugin.toml
MIT