pw agents

pw agents

Browse, attach to, and manage 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 agent command center: sessions grouped by project and filtered by status (needs you, working, ready, inactive), with a details pane showing each one's last message. From it you can open, start, fork, rename, pin, stop, archive, hide, or delete sessions, or start one in a new git worktree; press ? for the keys. Inside pw code, press ← at an empty prompt or run /agents to open it. 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, leaving out archived sessions; --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, archived ones included, not just live ones and recent history
  -h, --help            help for agents
  -o, --output string   Output format (interactive, text, json); interactive opens the agent command center 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