Skip to content

CLI: attach

Terminal window
npx cyberlegion attach [--clear | --show]

attach is the human’s read-pane. It binds the current pane as the hub’s main pane, the owner’s live presence, so surfaced mail has somewhere to land. It does not create or require an identity; binding is independent of unit register --standing, though the two are normally done together during onboarding. See Skill: init-cyberlegion.

Option Meaning
(bare) bind the current pane as the hub’s main pane
--show print the bound main pane instead of binding
--clear unbind the main pane (a no-op when nothing is bound)

Bare and --clear emit mainPane (the bound pane id, or none). --show emits the same shape without changing anything.

Bare attach fails if there is no multiplexer pane to bind. Run it from inside a tmux or herdr pane. --show and --clear never fail this way; they only read or clear the stored binding.

  • Mail Model: the owner mailbox this pane surfaces mail into
  • CLI: mux: mux doctor reports whether a pane is even available to bind
  • Skill: init-cyberlegion: the guided flow that offers to run this, only in a root session and only on an explicit yes