---
title: Status hooks & session control
description: The two opt-in switches behind the sidebar’s live statuses — hooks that let agents report what they’re doing, and the skill that teaches them to drive sibling sessions.
---

Two related, opt-in switches sit behind the live statuses you see in the sidebar:
**status hooks** that let agents report what they’re doing, and the **session
control** skill that teaches them to drive sibling sessions. Neither is required
to use Fyolo; both make a fleet of agents easier to run. The commands they
expose are documented in [Command-line tool](/docs/cli).

## Live agent status

Fyolo can install small **status hooks** into your agents’ own config files
(Claude Code, Codex, Cursor, and the plugin-based agents). When an agent starts
working, finishes, or stops to ask a question, the hook reports that to Fyolo, so
the sidebar’s [status dots](/docs/sidebar#status) reflect exactly what’s happening
instead of being guessed from output.

Turn it on from **Settings ▸ Agents ▸ Live agent status** (Fyolo also offers it
once on first launch). Toggling it off removes the hooks again, leaving any hooks
you added yourself untouched.

The switch says whether you want the feature; each machine installs it for its own
agents. Open a machine under **Settings ▸ Remote Hosts** and press **Set Up** — or
**Reinstall Hooks and Skill** on its **Agents** page — to put the hooks on that box. That is what gives
an agent running on a VPS the same status dots as one running here. See
[Devices](/docs/devices).

## Session control

**Settings ▸ Agents ▸ Session control** turns on the `fyolo sessions`
orchestration API below, and teaches your agents it exists by installing a
`fyolo` **agent skill** into each agent’s skills folder (`~/.claude/skills`,
`~/.codex/skills`). The skill loads on demand — an agent carries only its
one-line description until a task actually involves driving sibling sessions —
and Fyolo re-asserts it on every launch, so app updates propagate and
hand-edits heal automatically. Toggling it off removes the skill again.

<DocsImage
  src="/screenshots/docs/25-session-control-settings.png"
  alt="Fyolo settings with Command-line tool, Session control, and Live agent status enabled"
  width={1664}
  height={1288}
/>

Running an agent Fyolo doesn’t auto-configure? The same skill is published at
[fyolo.sh/skill.md](https://fyolo.sh/skill.md) and installable straight from
the repo:

```bash
npx skills add fl0wo/fyolo --skill fyolo
```

<Callout type="note">
  Both toggles only write files on your Mac — hook entries in agent configs and
  the skill file. Nothing leaves your machine: status reports and session
  commands travel over a local socket to the Fyolo app, and nowhere else.
</Callout>