Sessions

Sessions are persistent PTY processes that run in the background. They survive disconnects — start a process, close your terminal, reconnect later.

cw run creates a local PTY session. cw launch creates a workspace on the platform. See Platform commands for workspace management.

run

Start a new session in a persistent PTY.

cw run [name] [--dir <dir>] [--tag <tag>...] -- <command> [args...]

Flag	Description
`name`	Optional positional name before `--` for stable messaging identifier
`--dir`	Working directory for the process
`--tag`	Tags for filtering and orchestration (repeatable)

# Run with tags
cw run worker --dir ~/project --tag build -- claude -p "refactor the auth module"

# Run unnamed
cw run --tag lint -- eslint src/

attach

Connect to a running session interactively. Detach with Ctrl+B d.

cw attach [<id>] [--no-history]

Flag	Description
`id`	Session ID. Omit to auto-select the oldest unattached session
`--no-history`	Don’t replay buffered output on attach

list

Show all sessions with status, tags, age, and command.

cw list [node] [--json]

 ID  NAME      STATUS     TAGS           AGE     COMMAND
  1  planner   running    worker,build   2m ago  claude -p "refactor the auth module"
  2  coder     running    worker         45s     claude -p "implement changes"

kill

Terminate a session by ID, tag, or all.

cw kill <id> [--all] [--tag <tag>]

cw kill 1                    # kill session 1
cw kill --tag worker         # kill all workers
cw kill --all                # kill everything

logs

View captured output without attaching.

cw logs <id> [--follow] [--tail <N>]

Flag	Description
`--follow`, `-f`	Stream new output in real-time
`--tail`	Show last N lines

send

Send input to a session without attaching.

cw send <id> [input] [--stdin] [--file <path>] [--no-newline]

Flag	Description
`input`	Text to send as positional argument
`--stdin`	Read input from stdin
`--file`	Read input from a file
`--no-newline`	Don’t append a newline after input

watch

Monitor a session in real-time without attaching. Read-only observation.

cw watch <id> [--tail <N>] [--no-history] [--timeout <s>]

status

Get detailed session info including exit code, duration, tags, PID, and output stats.

cw status <id> [--json]

​Sessions

​run

​attach

​list

​kill

​logs

​send

​watch

​status

Sessions

run

attach

list

kill

logs

send

watch

status