YOLO CLI

Talk to your cloud. In plain English.

YOLO CLI is an interactive terminal application that lets you manage and query your AWS infrastructure using natural language. No more memorizing CLI flags or digging through console dashboards -- just ask for what you need.

Prerequisites

You'll need Node.js v20 or higher. The recommended way to manage Node versions is with NVM (Node Version Manager).

Installing NVM

Linux / macOS:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

After installation, restart your terminal (or source ~/.bashrc / source ~/.zshrc), then:

nvm install 20
nvm use 20

Windows:

Use nvm-windows instead. After installing it:

nvm install 20
nvm use 20

Verify your setup:

node --version
# v20.x.x or higher -- you're good

Getting Started

1. Create your account

Head over to runyolo.dev and sign up with your Google account. Takes about ten seconds.

2. Install the CLI

npm i -g -f @yolosystems/yolo-cli

3. Authenticate

Once you're signed in at runyolo.dev, you'll see your personal auth key on the dashboard. Copy it and run:

yolo-cli set-auth <your-auth-key>

Your credentials are encrypted and stored locally on your machine. Nothing is sent to our servers.

4. Launch

yolo-cli

That's it. You're in.

5. Connect your AWS account

Inside the CLI, run:

/paas-auth

This walks you through linking your AWS credentials (via credential file or manual entry). Once connected, you can start querying your infrastructure immediately.

Usage

YOLO CLI gives you a two-panel interactive terminal: output on top, input on the bottom. Just type what you want to know.

Natural language queries

Ask questions the way you'd ask a colleague:

list all running EC2 instances
show S3 buckets with public access
what RDS databases do I have in us-east-1
show me Lambda functions that were modified this week

Filters

Use @ filters to narrow your queries by service or region:

@service=ec2 @region=us-west-2 list all running instances
@service=s3 show bucket sizes and usage
@region=eu-west-1 what resources do I have
@service=ec2 @service=rds @region=us-west-2 show all resources

Type @ in the input to see available filter options with auto-completion.

Commands

Type / to see special commands. Here's the full list:

| Command | What it does | |---|---| | /paas-auth | Connect or re-authenticate your cloud account | | /resume | Pick up a saved conversation | | /export | Export the current conversation to clipboard or file | | /clear | Clear the output panel | | /theme | Switch the UI theme | | /feedback | Send feedback to the team | | /help | Show help inside the CLI | | /about | Application info | | /exit | Exit |

Navigation

• Up/Down arrows -- navigate auto-completion suggestions
• Tab / Enter -- select a suggestion
• Esc -- close the suggestion list
• Ctrl+C -- exit the application

Supported AWS Services

These services have the deepest support right now -- full read/query coverage and the most reliable results:

| Category | Services | |---|---| | Compute | EC2, Lambda, ECS, EKS | | Storage | S3 | | Database | DynamoDB, RDS | | Networking | VPC, CloudFront, Route 53, API Gateway | | Security | IAM, Cognito | | Containers | ECR |

Coverage for additional AWS services is actively expanding. You can still query other services -- results may vary as we build out deeper support.

All AWS regions are supported. Use the @region filter or just mention the region in your query.

Security

• Your auth key is encrypted using your machine's hardware ID and stored locally at ~/.yolo/.
• AWS credentials stay on your machine.
• No credentials are transmitted to YOLO servers.

Coming Soon

• Google Cloud Platform (GCP) support
• CoreWeave support

Troubleshooting

Permission errors on startup

Linux / macOS:

chmod 755 ~/.yolo && chown $USER ~/.yolo

Windows:

icacls "%USERPROFILE%\.yolo" /grant %USERNAME%:F

Auth key not working

Re-set your auth key:

yolo-cli set-auth <your-auth-key>

You can always grab a fresh key from runyolo.dev.

Node version issues

Make sure you're on v20+:

node --version

If not, use NVM to switch:

nvm install 20 && nvm use 20

Feedback & Support

Found a bug? Have a feature request? Use the /feedback command inside the CLI, or reach out through runyolo.dev.

Copyright 2026 YOLO Systems