Configuration
Every setting in the plugin's config.json.
Create config.json in the directory printed by herdr plugin config-dir timmo.agent-checks:
{
"pollSeconds": 30,
"retrySeconds": 120,
"timeoutSeconds": 30,
"concurrency": 3,
"showSuccess": true,
"showIdle": false,
"showPrevious": true,
"indicatorTemplates": {
"failure": "\uF52E !{count}",
"previous": "{status} ↶{count}"
},
"lint": {
"enabled": true,
"command": ["dot", "agent", "lint", "--json"],
"timeoutSeconds": 600,
"templates": { "failure": "\uF4B1 !{count}" }
},
"reviews": {
"enabled": true,
"pollSeconds": 60,
"templates": { "open": "\uF407 !{count}" }
},
"launchers": [{ "id": "pi", "label": "Pi", "argv": ["pi"], "agent": "pi" }]
}
pollSeconds(10-3600) sets how often idle branches are polled. Branches with unfinished runs are polled every 15 seconds until they finish. Every branch due shares one GraphQL query, and workspaces on the same branch share a poll.unfocusedPollSeconds(10-3600, default 120) is the shortest CI and review interval for workspaces not in focus, never shorter thanpollSeconds.retrySeconds(30-3600) is the wait after a failed poll, never shorter thanpollSeconds. Once GitHub’s rate limit is spent, polling waits until it resets.timeoutSeconds(5-120) bounds each command andconcurrency(1-8) bounds discovery and token updates.showPreviousfalls back to the nearest earlier first-parent commit with runs when the pushed commit has none, within the latest 100 commits.indicatorTemplateskeys arefailure,unavailable,loading,inProgress,success,idleandprevious.{count}is the number of failed runs, or the commit distance inprevious, where{status}is the wrapped indicator and{distance}reads like2 commits ago.lint.templateskeys arefailure,timedOut,running,cleanandunavailable.{count}is the number of failed checks. The lint command must printdot agent lint --jsonoutput, and accept its--alland--onlyflags for the panel’s run buttons.reviews.pollSeconds(30-3600) sets how often each branch’s reviews are polled.reviews.templateskeys areopen,requested,clearandunavailable.{count}is the number of open threads.launchersreplaces the built-in agents: OpenCode, Pi, Cursor Agent, Claude Code, Codex, GitHub Copilot, OMP, Devin, Droid, Kimi, Kilo, Hermes, Qoder CLI, Qwen, Mastra Code, Antigravity CLI and Grok. Only launchers with an installed Herdr integration and an executable command are offered.integrationoverrides the integration name, andverifyCommandprints the executable path expected in the new pane, for wrappers.