# 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.