agentmux

Managing TermCanvas agentmux agents

TermCanvas managed terminals are agentmux sessions. Each canvas is one agentmux project (for example termcanvas-8a075ab8-e), and each terminal node is an agent in that project. The canvas is a graph of peer agents — there is no commander, no manager, no fixed hierarchy. Use this skill to operate the live agent graph from the terminal.

Resolve the CLI first

Before running commands, resolve the agentmux executable in this order:

if [ -n "${AGENTMUX_BIN:-}" ] && [ -x "$AGENTMUX_BIN" ]; then
  AGENTMUX_CLI="$AGENTMUX_BIN"
elif [ -x "vendor/agentmux/agentmux" ]; then
  AGENTMUX_CLI="vendor/agentmux/agentmux"
elif command -v agentmux >/dev/null 2>&1; then
  AGENTMUX_CLI="$(command -v agentmux)"
else
  echo "agentmux runtime not found"
fi

Then run commands as "$AGENTMUX_CLI" ....

The skill is only the operating manual. The runtime comes from TermCanvas: packaged apps bundle it, development checkouts use vendor/agentmux, and advanced users may install agentmux on PATH.

Inside a TermCanvas-managed terminal, keep AGENTMUX_HOME unchanged. It points the CLI at the app's live agent database; without it, the CLI may read a stale default store and fail to see the current canvas.

Graph model

• Every agent is a peer. Any agent can spawn children, connect to any other agent in the same project, and delegate work.
• Spawning (worker, child) records a spawn edge between spawner and child. Agents created without a parent are roots (depth 0, no parent_agent).
• connect wires any two agents with a link edge. Edges are the addressing layer: ask/check work on agents you are connected to.
• One project tag equals one canvas. Keep agents in the same project so TermCanvas can materialize them on that canvas.
• TermCanvas registers every fresh canvas terminal as a root agent at creation (the shell carries AGENTMUX_* env, so harnesses started inside inherit it). Other plain terminals can be adopted into the graph with import (TermCanvas also does this automatically when you use its Connect UI).