Quick Start¶

1. Install¶

curl -fsSL https://yeager.sh/install | sh

2. Configure AWS credentials¶

yg configure

Follow the prompts to enter your AWS Access Key ID and Secret. Yeager validates the credentials and checks EC2 permissions automatically.

If you already have AWS credentials configured (aws configure), this step is optional.

3. Run your first command¶

yg echo 'hello from the cloud'

The first run takes ~2 minutes while Yeager: - Creates an EC2 instance (ARM64 Graviton t4g.medium) - Installs your project's toolchain - Syncs your project files via rsync - Runs the command and streams output back

Subsequent runs on the same VM start in seconds.

4. Run something real¶

# From your project directory:
yg pytest              # Python
yg cargo test          # Rust
yg npm run build       # Node.js
yg go test ./...       # Go
yg make build          # any Makefile target

5. Check what's running¶

yg status

6. Re-attach to a running command¶

yg logs               # replay + stream last run
yg logs --tail 50     # last 50 lines, then stream

7. Stop the VM when done¶

yg stop     # stops VM (no compute cost while stopped)
yg destroy  # terminates VM and cleans up all resources

Tips¶

Multiple terminals work: run yg pytest in one terminal and yg logs in another
Ctrl+C detaches, doesn't kill — the command keeps running on the VM
Use yg kill to actually cancel a running command
Use -- to pass flags to the remote command: yg -- ls -al