v1.3.11
Home GitHub

Drive It From the Browser

Last updated


Using the embedded web dashboard instead of the TUI, and where to read next.

Or drive it from the browser


The daemon serves a dashboard from the same port the API runs on. With agen running, open:
  1. http://127.0.0.1:17989

The page is embedded in the binary, so nothing is fetched from a remote host and nothing leaves your machine. Since v1.0.1 the third-party libraries it uses are downloaded once at daemon startup into ~/.config/agenvoy/vendor/ and served locally, and a service worker precaches the rest — so the dashboard keeps working with no network at all. Sessions, chat, schedules, skills, models, MCP servers and roles are all editable there (rules were renamed roles in v1.1.0; operator notes were removed in v1.0.23). Since v1.2.0 the sidebar lists Schedule and Skills next to Roles; the Skills page adds a Skill Source panel that turns whole skill sources on or off, and a schedule's test button reads test in <session prefix + 8 hex> and opens that session's chat (cli- sessions included). Since v1.0.12 the System settings panel also holds the Telegram / Discord / admin channel setup (moved out of its own page), launch-on-login, reply language, Official guide (v1.2.0) and the output directory with an open dir shortcut. The Other group below it holds the Update card, which compares the running build against the latest GitHub release and can start agen update in a terminal window (moved here in v1.2.0), then the Doc, License and Source entries; the last two are the notices AGPL-3.0 §7(b) requires the interface to keep (v1.0.16) — see License.
Since v1.3.0 the chat folds a task's earlier replies into collapsible blocks, each titled by the message that started it (Background for a turn with no visible prompt, such as a finished background group since v1.3.8); once the task is no longer pending only the replies to follow-up messages stay folded above the final one. Since v1.3.1 the reasoning trace opens with Model(<model> <level>) and adds Switch(...) when fallback moves to another model; a reload drops these lines from completed turns. The model of a reply shows when its footer is hovered (v1.3.0).
Since v1.2.2 replies and opened Markdown files render charts, diagrams and formulas — see Rendered with NanoMD.
To run one request without the TUI, post it:
  1. curl -sS -H 'Content-Type: application/json' \
  2.   -d '{"content":"summarize the latest changes in main.go"}' \
  3.   http://127.0.0.1:17989/v1/send

Without session_id the request runs in a new temporary session; model and skill are optional. There is no allow_all field.

Next steps


  • Sessions & Agents — sessions, agent routing, and subagents
  • Execution Engine — the iteration loop and three-pass tool dispatch
  • Providers — supported LLM backends and the dispatcher model
  • MCP Client — plug in external tool servers
  • CLI Commands — full command list
中文