> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clawup.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# ssh

> SSH into an agent by name or alias

Connect to an agent via Tailscale SSH. Supports agent names and aliases.

## Usage

```bash theme={null}
clawup ssh <agent> [command...] [options]
```

## Arguments

| Argument     | Description                                          |
| ------------ | ---------------------------------------------------- |
| `agent`      | Agent name or alias (e.g., `titus`, `juno`, `scout`) |
| `command...` | Optional command to run on the agent                 |

## Options

| Option              | Description                                        |
| ------------------- | -------------------------------------------------- |
| `-u, --user <user>` | SSH user (default: `ubuntu`)                       |
| `--local`           | Connect to local Docker container instead of cloud |

## Agent Aliases

| Alias   | Agent        | Role     |
| ------- | ------------ | -------- |
| `juno`  | agent-pm     | PM       |
| `titus` | agent-eng    | Engineer |
| `scout` | agent-tester | Tester   |

## Examples

```bash theme={null}
# Interactive SSH session
clawup ssh titus

# Run a command
clawup ssh titus uptime

# Use full agent name
clawup ssh agent-eng

# Custom SSH user
clawup ssh titus -u root
```