@yolosystems/yolo-cli

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