Parallel Works
View as Markdown
Share:

pw agents

pw agents

Browse and attach to pw code agent sessions on this machine

Synopsis

Browse pw code agent sessions and their live status: running, awaiting approval, idle, or live on another host sharing this session store.

The default interactive mode opens the session picker — choose a session to attach to it, or start a fresh one. It downgrades to the text listing when stdout is not a terminal. The text view shows every live session plus the most recent idle ones; --all lists the whole session store. Listing never starts a daemon; attaching does.

pw agents [flags]

Examples

  pw agents
  
  # Live sessions plus recent history, as text
  pw agents -o text
  
  # Every saved session
  pw agents -o text --all
  
  # List as JSON
  pw agents -o json

Options

  -a, --all             List every saved session, not just live ones and recent history
  -h, --help            help for agents
  -o, --output string   Output format (interactive, text, json); interactive opens the session picker and downgrades to text when stdout is not a terminal (default "interactive")

Options inherited from parent commands

      --context string         The context to use. Overrides PW_CONTEXT environment variable and current context from config.
      --platform-host string   The Parallel Works ACTIVATE platform host to use. Overrides PW_PLATFORM_HOST environment variable and the current context's server.
  -v, --verbose                Enable verbose logging

SEE ALSO

  • pw - The Parallel Works ACTIVATE CLI