Agents
Status hooks & session control
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 Termio; both make a fleet of agents easier to run. The commands they expose are documented in Command-line tool.
Live agent status
Termio 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 Termio, so the sidebar’s status dots reflect exactly what’s happening instead of being guessed from output.
Turn it on from Settings ▸ Agents ▸ Live agent status (Termio 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.
Session control
Settings ▸ Agents ▸ Session control turns on the termio sessions
orchestration API below, and teaches your agents it exists by installing a
termio 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 Termio re-asserts it on every launch, so app updates propagate and
hand-edits heal automatically. Toggling it off removes the skill again.
Running an agent Termio doesn’t auto-configure? The same skill is published at termio.sh/skill.md and installable straight from the repo:
npx skills add termio-sh/termio --skill termioBoth 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 Termio app, and nowhere else.
Custom agents
Teach Termio about any CLI by dropping a small JSON manifest in ~/.termio/config/agents — give it a name, an icon, and live status detection, and it becomes a first-class agent alongside the built-ins.
Git worktrees
Termio reads your repository’s worktrees straight from git and shows them as a nested branch under the project, so parallel agent work stays isolated.