Skip to main content

​
Send one agent a request

Cyclops durably accepts the message before returning, then queues the summary and exact claim as the recipient’s guarded pane notification. The receipt keeps those facts separate: accepted covers the mailbox record, while wake <state> reports the current notification attempt. A socket claim may retrieve the body before the pane notification appears. That claim does not cancel the separately queued human-visible notification; Cyclops still stages the summary and exact claim when the composer is safe. The Messages view records the mailbox and wake outcomes separately. In doorbell mode, the wake carries an exact attempt token. Running that command atomically claims the message currently bound to the attempt. A recipient may also list and claim by message id:
The terminal wake carries the one-line summary and exact claim command. It may visually soft-wrap in a narrow pane, but Cyclops does not drop the summary. The authenticated claim returns the rich envelope instead:
The labels are the immutable presentation captured at acceptance time. A later pane rename changes neither the record nor this envelope. The wake is one-shot. An ambiguous terminal outcome raises one attention item and leaves the message claimable. Do not resend or requeue blindly. Follow Recover a notification for inspection, guarded completion or discard, and provably pre-write withdrawal.

​
Broadcast

A broadcast creates one immutable message with one mailbox entry and one wake state per recipient. --all targets adopted agents, not the admin inbox.

​
Wait for pane activity

turn-ended means Cyclops observed working followed by idle or idle_with_input for the same pane occupant. If the process in the pane changes while waiting, Cyclops exits separately instead of answering for the replacement. This observes pane activity. It does not identify a turn, prove write readiness, or prove that a specific message or task was completed.

​
Watch live

The stream is calm by default and can switch to a firehose of every message and state event. A bare cyclops opens the larger workspace interface with the same event record beside live pane canvases.

​
Read the record

The workspace message journal is append-only. history applies caller-scoped visibility to the durable conversation. messages is the body-free view of mailbox and wake state:
Cyclops does not currently implement a pipe command or a send --from shortcut. Put the relevant context in --body, pipe it through --body-file -, or send a file’s contents with --body-file <path>.