← ClaudeAtlas

qol-sessionslisted

Use when an architect must create or drive an implementation agent in another terminal through event-signalled implementation and review rounds until a feature is accepted. Also use for cross-terminal handoffs, relays, bridges, or independent agent sessions. The agent surface is sessions_list, session_spawn, session_bridge, and session_loop_close; product, model, and session names are never part of the workflow contract.
qol-tools/qol-skills · ★ 0 · AI & Automation · score 62
Install: claude install-skill qol-tools/qol-skills
# qol-sessions Use one event-driven transaction per implementation round and repeat rounds until the architect accepts the feature. Do not assemble a relay from separate send, read, wait, status, or polling calls. Every round is fire-and-forget: deliver it (`session_spawn` with `background: true` and `task`, or `session_submit`), end the architect turn, and let the watcher's wake message resume the architect. A foreground round that suspends the architect inside a tool call is not part of this workflow: never pass `task` to `session_bridge`, and never call `session_bridge` before a wake arrives. Bridge is the collection call after a wake, and the recovery call for an interrupted round. ## Public actions | Action | Purpose | |---|---| | `sessions_list()` | Discover live terminals and their stable session tokens | | `session_spawn(tool, cwd, key, model?, title?, group?, task, background: true)` | Launch a keyed implementation terminal (titled, on the flash tier) or reuse its matching live session, then return its token; `model` names the lane's tier override, `title` names the tab (defaults to the lane key), `group` tags a set of research lanes for grouped delivery (see below), `task` carries the first round, and `background: true` (always) queues the round at spawn time and returns before the lane is live | | `session_submit(session, task, acknowledge_marker?)` | Deliver one bounded round to a live lane and return immediately with the round open; used for every round after