The tmux subdomain of the host's swarm tool: Claude and Codex discovery,
with Claude compaction, re-seed and goal restore.
swarm tmux panes assistant panes with provider and capabilities; Claude: pane, target, name, session id, cwd, ctx-tokens, busy?, status, goal-active?, goal-age swarm tmux compact compact one pane, or every pane over threshold swarm tmux job one compaction job by id, or all of them
The `tmux` subdomain of the host's `swarm` tool: Claude and Codex discovery,
with Claude compaction, re-seed and goal restore.
swarm tmux panes assistant panes with provider and capabilities;
Claude: pane, target, name, session id, cwd,
ctx-tokens, busy?, status, goal-active?, goal-age
swarm tmux compact compact one pane, or every pane over threshold
swarm tmux job one compaction job by id, or all of themOwnership key for contributions, so retraction removes only ours.
Ownership key for contributions, so retraction removes only ours.
(caller-pid caller-id)The pid in a coordinator:<pid> caller id (the host stamps it on every call
as _caller_id), or nil. It is the pid of the caller's own Claude Code
process, which is the :pid of the session its pane row joins.
The pid in a `coordinator:<pid>` caller id (the host stamps it on every call as `_caller_id`), or nil. It is the pid of the caller's own Claude Code process, which is the :pid of the session its pane row joins.
(cancel-cmd params)tmux cancel job_id=<id>: cancel a job that has not typed yet. The same
as tmux job job_id=<id> cancel=true.
`tmux cancel job_id=<id>`: cancel a job that has not typed yet. The same as `tmux job job_id=<id> cancel=true`.
(compact-cmd params)pane given: compact those panes, whatever their size.
pane omitted: every Claude pane over threshold, except those in exclude.
dry_run: say what would be compacted, start nothing.
Only Claude panes compact: an explicit selection holding a pane without
the :compact capability (e.g. Codex) starts no job.
The caller's own pane (_caller_id) is never compacted here: named, the
call is refused at once; in a sweep it is left out and reported, both
pointing at swarm steer self (see self-compact).
supersede needs an explicit pane: a sweep with it is refused, since it
would cancel queued jobs on every due pane.
pane given: compact those panes, whatever their size. pane omitted: every Claude pane over threshold, except those in exclude. dry_run: say what would be compacted, start nothing. Only Claude panes compact: an explicit selection holding a pane without the :compact capability (e.g. Codex) starts no job. The caller's own pane (`_caller_id`) is never compacted here: named, the call is refused at once; in a sweep it is left out and reported, both pointing at `swarm steer self` (see `self-compact`). supersede needs an explicit pane: a sweep with it is refused, since it would cancel queued jobs on every due pane.
(contribute!)Graft swarm tmux ... onto the host and register the pane senses with
sixth-sense. The verbs need only the tmux CLI, not libtmux, so the addon
contributes them before its preflight runs.
Graft `swarm tmux ...` onto the host and register the pane senses with sixth-sense. The verbs need only the tmux CLI, not libtmux, so the addon contributes them before its preflight runs.
(goal-cmd params)Arm or replace a supported pane's /goal without compacting it.
Arm or replace a supported pane's /goal without compacting it.
(own-pane? row pid)Does ROW show the session of the caller whose pid is PID?
Does ROW show the session of the caller whose pid is PID?
(pane-refs x)The one normalizer for every pane-ref list parameter (pane, exclude), as a
Result: (r/ok refs), REFS a vector of trimmed, non-blank ref strings or nil
when there are none. Accepted: an array (as data, or as its printed or JSON
text: ["%9" "%5"] and ["%9", "%5"] both read, commas being
whitespace to the EDN reader), a comma-separated string, or one ref. A
bracketed text that is not an array of strings is (r/err
:tmux/bad-pane-refs), never read as a ref: excluding nothing because of a
stray bracket is the bug this exists to stop.
The one normalizer for every pane-ref list parameter (pane, exclude), as a Result: (r/ok refs), REFS a vector of trimmed, non-blank ref strings or nil when there are none. Accepted: an array (as data, or as its printed or JSON text: `["%9" "%5"]` and `["%9", "%5"]` both read, commas being whitespace to the EDN reader), a comma-separated string, or one ref. A bracketed text that is not an array of strings is (r/err :tmux/bad-pane-refs), never read as a ref: excluding nothing because of a stray bracket is the bug this exists to stop.
(read-cmd params)Read a terminal screen. Claude panes can also return transcript text.
Read a terminal screen. Claude panes can also return transcript text.
(retract!)Withdraw swarm tmux ..., stop the pane watcher, unregister the senses.
Withdraw `swarm tmux ...`, stop the pane watcher, unregister the senses.
(say-cmd params)Submit one prompt to a pane with a tested input contract.
Submit one prompt to a pane with a tested input contract.
Where the caller compacts its own pane instead.
Where the caller compacts its own pane instead.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |