How do I install the Fly CLI skill?

Run npx skillmds@latest add grandamenium/fly-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Fly CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Fly CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Fly CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Fly CLI?

grandamenium (@grandamenium) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Fly CLI by grandamenium — Agent Skill

Name: Fly CLI
Author: grandamenium

File contents

Fly.io CLI (flyctl / fly)

Official CLI for Fly.io. Deploy apps globally to edge locations with Firecracker VMs.

Official repo: https://github.com/superfly/flyctl
Docs: https://fly.io/docs/flyctl/

Authentication

fly auth login                            # Browser-based login
fly auth token                            # Print auth token
fly auth whoami                           # Check current user

Common Commands

Apps

fly launch                                # Create and configure new app
fly deploy                                # Deploy current directory
fly deploy --image my-registry/my-app:v1  # Deploy specific image
fly apps list
fly status                                # Current app status
fly open                                  # Open app in browser

Machines

fly machine list
fly machine start MACHINE_ID
fly machine stop MACHINE_ID
fly machine restart MACHINE_ID
fly machine status MACHINE_ID

Scaling

fly scale count 3                         # Set instance count
fly scale vm shared-cpu-1x                # Change VM size
fly scale memory 512                      # Set memory (MB)
fly scale show                            # Show current scale
fly regions add ord                       # Add region
fly regions list                          # List regions

Secrets

fly secrets set DATABASE_URL=postgres://...
fly secrets list
fly secrets unset DATABASE_URL

Logs and SSH

fly logs                                  # Stream logs
fly ssh console                           # SSH into running machine
fly ssh console -C "ls /app"              # Run command via SSH

Databases

fly postgres create                       # Create managed Postgres
fly postgres list
fly postgres connect -a my-db             # Connect to Postgres

Volumes

fly volumes create my_data --size 10      # Create 10GB volume
fly volumes list

Agent Best Practices

Use fly status to check app health and deployment status
Use fly deploy --strategy rolling for zero-downtime deploys
Use fly logs to debug issues after deployment
Set secrets before deploying: fly secrets set triggers a redeploy
Use fly ssh console -C "command" for one-off remote commands
Use fly scale count to manage instance count per region

Example Workflows

Deploy and verify

fly deploy
fly status
fly logs --instance INSTANCE_ID

Scale to multiple regions

fly regions add lax ord ams
fly scale count 2

---name: fly-clidescription: Use the Fly.io CLI (flyctl) to deploy applications to edge locations, manage machines, volumes, secrets, and databases.---# Fly.io CLI (flyctl / fly)Official CLI for Fly.io. Deploy apps globally to edge locations with Firecracker VMs.- **Official repo:** https://github.com/superfly/flyctl- **Docs:** https://fly.io/docs/flyctl/## Authentication```bashfly auth login # Browser-based loginfly auth token # Print auth tokenfly auth whoami # Check current user```## Common Commands### Apps```bashfly launch # Create and configure new appfly deploy # Deploy current directoryfly deploy --image my-registry/my-app:v1 # Deploy specific imagefly apps listfly status # Current app statusfly open # Open app in browser```### Machines```bashfly machine listfly machine start MACHINE_IDfly machine stop MACHINE_IDfly machine restart MACHINE_IDfly machine status MACHINE_ID```### Scaling```bashfly scale count 3 # Set instance countfly scale vm shared-cpu-1x # Change VM sizefly scale memory 512 # Set memory (MB)fly scale show # Show current scalefly regions add ord # Add regionfly regions list # List regions```### Secrets```bashfly secrets set DATABASE_URL=postgres://...fly secrets listfly secrets unset DATABASE_URL```### Logs and SSH```bashfly logs # Stream logsfly ssh console # SSH into running machinefly ssh console -C "ls /app" # Run command via SSH```### Databases```bashfly postgres create # Create managed Postgresfly postgres listfly postgres connect -a my-db # Connect to Postgres```### Volumes```bashfly volumes create my_data --size 10 # Create 10GB volumefly volumes list```## Agent Best Practices- Use `fly status` to check app health and deployment status- Use `fly deploy --strategy rolling` for zero-downtime deploys- Use `fly logs` to debug issues after deployment- Set secrets before deploying: `fly secrets set` triggers a redeploy- Use `fly ssh console -C "command"` for one-off remote commands- Use `fly scale count` to manage instance count per region## Example Workflows### Deploy and verify```bashfly deployfly statusfly logs --instance INSTANCE_ID```### Scale to multiple regions```bashfly regions add lax ord amsfly scale count 2```

Frequently asked questions

Fly CLI