shelbi attach

View as markdown
shelbi attach [OPTIONS] <ID>

shelbi attach connects your terminal to a workspace's tmux pane, dropping you straight into the agent's session so you can watch or drive it interactively.

Where shelbi open focuses (and, if needed, creates) the pane inside the Shelbi tmux session, attach wires your terminal to the workspace's pane directly.

Arguments

ArgumentTypeDefaultDescription
<ID>stringWorkspace to attach to (required).

Flags

FlagTypeDefaultDescription
--root <PATH>stringinstall-time default / $SHELBI_ROOT / ~/.shelbiOverride the Shelbi root directory. The flag wins over both the env var and the compile-time default.
-p, --project <PROJECT>stringenv / cwd lookupProject to operate on.

Examples

Attach your terminal to the alpha workspace's pane:

shelbi attach alpha

See also

  • Workspaces — what a workspace is and how its pane is created and owned.
  • shelbi open — focus (or create) a workspace's pane inside the Shelbi tmux session rather than attaching your own terminal to it.