# pw agents

> Source: https://parallelworks.com/docs/cli/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

```
  # Pick a session and attach
  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](/docs/cli/pw)	 - The Parallel Works ACTIVATE CLI