68 lines
3.0 KiB
Markdown
68 lines
3.0 KiB
Markdown
|
# TaskSquad — Agents
|
||
|
|
|
||
|
|
Field-tested against tasksquad.ai on 2026-05-03 using a logged-in Chrome session.
|
||
|
|
|
||
|
|
## URL
|
||
|
|
|
||
|
|
```
|
||
|
|
https://tasksquad.ai/dashboard/agents # Agents list for current project
|
||
|
|
```
|
||
|
|
|
||
|
|
## Agent list
|
||
|
|
|
||
|
|
Agents are the daemon workers that execute tasks. Each agent card shows:
|
||
|
|
- Name
|
||
|
|
- Status badge (`active` / `inactive` / `running` / `waiting_input` / `paused`)
|
||
|
|
- Role (optional label set by maintainer)
|
||
|
|
- Last-seen timestamp
|
||
|
|
|
||
|
|
Navigate to agents via the sidebar link "Agents".
|
||
|
|
|
||
|
|
## Creating an agent
|
||
|
|
|
||
|
|
Maintainer/owner only. Click **"New agent"** (or similar CTA in the agents view).
|
||
|
|
|
||
|
|
Provide:
|
||
|
|
- **Name** — display name for the agent
|
||
|
|
- **Role** (optional) — a freeform string describing the agent's specialty
|
||
|
|
|
||
|
|
After creation, a **token** is generated. Copy it immediately — it is shown only once. The daemon uses this token to authenticate.
|
||
|
|
|
||
|
|
```
|
||
|
|
tsq install --token <TOKEN>
|
||
|
|
```
|
||
|
|
|
||
|
|
Tokens are created via `POST /teams/:teamId/tokens` with `{ label, agent_id }`.
|
||
|
|
|
||
|
|
## Agent statuses
|
||
|
|
|
||
|
|
| Status | Meaning |
|
||
|
|
|-----------------|----------------------------------------------------|
|
||
|
|
| `active` | Daemon connected, ready to accept tasks |
|
||
|
|
| `inactive` | Daemon not connected (no recent ping) |
|
||
|
|
| `running` | Currently executing a task |
|
||
|
|
| `waiting_input` | Paused mid-task, waiting for user reply |
|
||
|
|
| `paused` | Manually paused — will not pick up new tasks |
|
||
|
|
|
||
|
|
## Agent actions (maintainer / owner)
|
||
|
|
|
||
|
|
| Action | Trigger | Effect |
|
||
|
|
|--------------|--------------------------|-----------------------------------------------------|
|
||
|
|
| Pause/Resume | Toggle button on card | Sets `paused` flag — agent ignores new tasks |
|
||
|
|
| Reset | "Reset" button | Clears the agent's running state (use if stuck) |
|
||
|
|
| Delete | Delete button / menu | Permanently removes agent and its tokens |
|
||
|
|
| Edit role | Role edit control | Updates the agent's role label |
|
||
|
|
|
||
|
|
## Token management
|
||
|
|
|
||
|
|
Tokens are per-agent credentials. Each token has a label. A maintainer can:
|
||
|
|
- **Generate a new token** — use when setting up a new machine or rotating credentials
|
||
|
|
- Tokens cannot be viewed after creation; only revoked implicitly by deleting the agent
|
||
|
|
|
||
|
|
## Gotchas
|
||
|
|
|
||
|
|
- **Status is driven by daemon pings**, not task state. An agent can be `active` while no task is running.
|
||
|
|
- **`inactive` ≠ paused.** Inactive means the daemon process is offline. Paused means a maintainer explicitly suspended it via the UI.
|
||
|
|
- **Only owners and maintainers can create agents or generate tokens.** Members see the list but cannot modify it.
|
||
|
|
- **Token is shown once.** If you miss copying it, you must generate a new one — there is no "reveal token" button.
|
||
|
|
- **Reset is for recovery only.** Use it when an agent is stuck in `running` after a daemon crash. Do not reset agents mid-task.
|