# pw code attach

> Source: https://parallelworks.com/docs/cli/pw/code/attach

## pw code attach

Attach the TUI to pw code sessions on a remote resource

### Synopsis

Connect this terminal's TUI to the pw code daemon on a remote resource
over SSH. Sessions run on the resource — its workspace, its tools, its
transcripts — and this TUI renders and steers them.

With only a resource, the session picker lists the resource's sessions.
Append /<session-id> to attach to one directly, or pass -w with a remote
workspace path to start a new session there.

```
pw code attach <resource>[/<session-id>] [flags]
```

### Examples

```
  # Browse and resume the resource's sessions
  pw code attach gcpv2
  
  # Attach to one session directly
  pw code attach gcpv2/20260819-101500-ab12cd34
  
  # Start a new session in a remote workspace
  pw code attach -w /home/user/project -m org:openai/gpt-5.2 gcpv2
```

### Options

```
      --allocation string        Budget allocation for a new session
      --effort string            Reasoning effort for a new session
  -h, --help                     help for attach
  -m, --model string             Model ID for a new session
      --permission-mode string   Permission mode: read-only, accept-edits, bypass-permissions, plan
  -w, --workspace string         Remote workspace path for a new session
```

### 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 code](/docs/cli/pw/code)	 - AI coding agent