connect / ssh

Open an interactive shell to a utopia server via SSM Session Manager. Zero SSH keys. ssh is an alias with the same behavior (not OpenSSH).

awsutopia connect <name> [--force] [--dry-run] [--json] [--profile] [--region]
awsutopia ssh <name> …

awsutopia connect web
awsutopia connect web --dry-run    # prints the planned aws ssm start-session

What happens

1. Resolves the utopia-tagged instance (current project+env; --force for other utopia servers)
2. Checks SSM agent is Online
3. Runs aws ssm start-session --target <instance-id>

Needs AWS CLI v2 and the Session Manager plugin on your machine.

Clear errors

Code	Meaning
SERVER_NOT_FOUND	No tagged server with that short name
SERVER_PROJECT_MISMATCH	Tagged for another project — switch or --force
SSM_AGENT_NOT_READY	Instance booting or missing instance profile / outbound HTTPS
SSM_ACCESS_DENIED	Your IAM can’t call ssm:DescribeInstanceInformation
AWS_CLI_MISSING	aws binary / plugin not runnable

--dry-run never starts a session — it only prints the intent.