| name | termio |
| description | See and drive the sibling agent sessions running alongside you on this machine via the `termiod` CLI — list them and their status, start a new agent or plain-terminal session, send a prompt or an answer into one, and set your own status. Use when delegating work to another session, or checking on what other sessions are doing. Do not use merely because a task could run in parallel. Requires running inside a termiod session (TERMIOD_SESSION_ID set). |
Driving sibling sessions (termiod)
If TERMIOD_SESSION_ID is not set in your environment, you are not running
inside a termiod session — say so and stop instead of trying to drive sessions
you cannot see.
You are running inside a session hosted by termiod on this machine, alongside
other sessions on the same host. Coordinate with them through the termiod
CLI. The installed CLI is the authority on syntax: where this text and
termiod --help disagree, trust the CLI.
Sessions here are scoped to this machine, not to a project. The daemon lists
every session it hosts, so read the names and working directories before acting
on one — there is no project filter to lean on.
termiod list --json — every session on this host, with its status
(working / idle / needs_you / done / failed / unknown), name, and
pid. Sessions are addressed by id or by name; both work everywhere a target
is taken.termiod send <target> "<text>" — type into a session as if the user had.
Use it to answer a sibling that is blocked on a question. --no-enter types
the text without pressing Enter.termiod create --name <name> --cwd <dir> -- <program> [args…] — start a new
session and print its id. With no -- argv it starts a login shell.termiod kill <target> — kill a session and its process group.termiod set-status "$TERMIOD_SESSION_ID" <state> — report your own state.
Valid states are working, idle, needs_you, done, failed, and
unknown. --title "<short label>" sets the label a viewer shows beside the
session.
When to use this
- Delegating. A task that is genuinely separate work — a long build, an
independent investigation — can go to a new session so the user watches it in
its own pane.
- Supervising. Before reporting that something is done, check whether a
sibling you started is still
working or has gone needs_you.
- Unblocking. A sibling sitting at
needs_you is waiting on a human. If you
can answer it from what you already know, send the answer.
Do not spawn a session merely because two things could happen at once. A
session the user did not ask for and does not watch is noise.
What is not available here
Unlike the same skill on a Mac running the termio app, there is no transcript
reader and no project-scoped listing: termiod hosts sessions, and the
project a session belongs to is not yet readable back from it. Do not guess at a
sibling's conversation contents — ask it with send, or read what the user
tells you.
