mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
51 lines
3.1 KiB
Markdown
51 lines
3.1 KiB
Markdown
|
# Agents & work sessions
|
||
|
|
|
||
|
|
The **Agents** page (`/agents`) is your view of the workforce: who's running, who's idle, who's stuck, and what each one is costing in tokens. From an agent's detail page you can spawn or stop it and watch its reasoning live. The **Work Sessions** ledger (`/work-sessions`) is the read-only record of every branch-and-PR an agent has worked, tying git activity back to the agents that produced it.
|
||
|
|
|
||
|
|
## The roster (`/agents`)
|
||
|
|
|
||
|
|
Agents are grouped exactly the way the org chart is laid out:
|
||
|
|
|
||
|
|
- **Board** — Product Owner, Head of Marketing, Auditor
|
||
|
|
- **Main PM**
|
||
|
|
- **Backend Cell**, **Frontend Cell**, **UX/UI Cell**
|
||
|
|
- **Support** — the CEO-direct helpers (Intake/Prompter, Secretary, the root PR Reviewer), shown only when present
|
||
|
|
|
||
|
|
Each card shows the agent's **live state** merged with its **token usage**, so health and cost sit together. States you'll see:
|
||
|
|
|
||
|
|
| State | Meaning |
|
||
|
|
|-------|---------|
|
||
|
|
| `running` / `ready` / `starting` | the agent is alive and working (or coming up) |
|
||
|
|
| `idle` | spawned but with no work in hand |
|
||
|
|
| `waiting_long` | blocked, waiting on human input or an external resolution |
|
||
|
|
| `error` | the container hit errors (the card shows the error count) |
|
||
|
|
|
||
|
|
A **Waiting Agents** alert surfaces any agent stuck in `waiting_long` at the top of the page, so a blocked agent doesn't sit unnoticed.
|
||
|
|
|
||
|
|
## Agent detail (`/agents/[id]`)
|
||
|
|
|
||
|
|
Open an agent to control it and watch it think. The page gives you:
|
||
|
|
|
||
|
|
- **Spawn** — bring the agent's container up.
|
||
|
|
- **Stop** (graceful) and **Force Stop** — wind it down cleanly or kill it immediately.
|
||
|
|
- **Resolve Wait** — when an agent is in `waiting_long`, this dialog is how you hand it the input or decision it's blocked on.
|
||
|
|
- **Live stream viewer** — while the agent is active, a viewer streams its reasoning in real time over the agent WebSocket, so you can literally watch it work.
|
||
|
|
|
||
|
|
!!! tip "Stop the bleeding"
|
||
|
|
If an agent is crash-looping or burning tokens, **Force Stop** from its detail page is the fastest way to halt it. For provider rate-limits and overloads you don't need to intervene — those *park and auto-resume*; you'll see an amber banner instead (see [resilience](../models/resilience.md)).
|
||
|
|
|
||
|
|
Per-agent token spend rolls up into the [Metrics](./metrics.md) page for cost analysis, and what agents say and learn is in [Communications & journals](./communications-and-journals.md).
|
||
|
|
|
||
|
|
## Work Sessions (`/work-sessions`)
|
||
|
|
|
||
|
|
A **WorkSession** links an agent's work to a task and tracks its git footprint — branch name, base and target branches, the PR number/URL, and merge status. The Work Sessions page is a **read-only ledger** of those sessions, with search-by-branch and a status filter (state, again, lives in the URL).
|
||
|
|
|
||
|
|
!!! note "No sidebar link"
|
||
|
|
Work Sessions has **no entry in the sidebar nav**. Reach it by typing `/work-sessions` directly or by following a link from elsewhere in the panel. It's a reference ledger, not a daily-driver page.
|
||
|
|
|
||
|
|
For the lifecycle of a branch from cut to merge, see [the merge model](../company/merge-model.md).
|
||
|
|
|
||
|
|
## Next
|
||
|
|
|
||
|
|
→ [Git](./git.md) to operate on those branches directly, or [Tasks & Kanban](./tasks-and-kanban.md) to see the work the agents are running.
|