alpacon work-session use

Set the active work session for the current workspace by passing its session ID. Subsequent exec, websh, cp, and tunnel commands attach to this session unless overridden with --work-session. Pass --unset (with no session ID) to clear the active work session.

Only a session in the active state can be set. An agent session (one whose requester type is agent) is refused even when active: it cannot be the workspace’s active session, so pass its ID to each command with --work-session, or set ALPACON_WORK_SESSION in the agent’s environment.

bash
alpacon work-session use SESSION_ID [flags]

Options

bash
  -h, --help    help for use
      --unset   Clear the active work-session for the current workspace

Examples

Set the active session:

bash
alpacon work-session use 11111111-2222-3333-4444-555555555555

Clear the active session:

bash
alpacon work-session use --unset

See Selecting a session for how the active session interacts with the --work-session flag and the ALPACON_WORK_SESSION environment variable.

Last updated: