termio

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.