Agent-Skills.md

Agent Skills: Fly.io Sprites

Operate Fly.io Sprites via the `sprite` CLI as persistent remote Linux machines. Use when asked to create, list, select, inspect, use, or destroy a Sprite; run commands with `sprite exec`, open an interactive shell with `sprite console`, install packages, clone repos, edit files, serve or expose an app, check or change a Sprite URL, proxy ports, create/list/inspect/restore checkpoints, or troubleshoot common Sprite workflows including wake-up behavior, wrong target selection, auth, networking, and storage.

UncategorizedID: kaofelix/dotfiles/fly-sprites

Repository

kaofelix/dotfiles
kaofelix
11

Install this agent skill to your local

pnpm dlx add-skill https://github.com/kaofelix/dotfiles/tree/HEAD/pi/.pi/agent/skills/fly-sprites

Skill Files

Browse the full folder contents for fly-sprites.

Download Skill

Loading file tree…

pi/.pi/agent/skills/fly-sprites/SKILL.md

Skill Metadata

Name
fly-sprites
Description
Operate Fly.io Sprites via the `sprite` CLI as persistent remote Linux machines. Use when asked to create, list, select, inspect, use, or destroy a Sprite; run commands with `sprite exec`, open an interactive shell with `sprite console`, install packages, clone repos, edit files, serve or expose an app, check or change a Sprite URL, proxy ports, create/list/inspect/restore checkpoints, or troubleshoot common Sprite workflows including wake-up behavior, wrong target selection, auth, networking, and storage.

Fly.io Sprites

Use this skill as the default operator guide for Fly.io Sprites. Assume the CLI is installed and authenticated.

Sprites are like on demand Linux VPSs running Ubuntu that can be created and destroyed when needed.

Home folder: /home/sprite

Some basic software comes pre installed:

  • Languages: Node.js, Python, Go, Ruby, Rust, Elixir, Java, Bun, Deno
  • Utilities: Git, curl, wget, vim, and common dev tools

Commands

Create or destroy

sprite create my-sprite
sprite destroy my-sprite

Only destroy when the user explicitly wants permanent deletion.

Select a Sprite

sprite list
sprite use my-sprite
sprite -o my-org -s my-sprite exec pwd

Prefer local .sprite context when present. Use explicit -o and -s when the target is ambiguous.

Run commands

Use sprite exec for one-off commands and automation:

sprite exec echo "hello"
sprite exec bash -c "cd /home/sprite && ls -la"

Use sprite console for interactive work:

sprite console

URL

sprite url
sprite url update --auth public
sprite url update --auth sprite

Keep URLs private unless the user explicitly wants public access.

Proxy ports

sprite proxy 5432
sprite proxy 3001:3000
sprite proxy 3000 8080 5432

Use this for databases, dev servers, and other private ports.

Checkpoint and restore

sprite checkpoint create
sprite checkpoint create --comment "before upgrade"
sprite checkpoint list
sprite checkpoint info <id>
sprite restore <id>

Create a checkpoint before risky upgrades, migrations, or destructive experiments.

Common Tasks

Run a command in the machine

sprite exec bash -c "cd /home/sprite/app && git status"

Serve a quick app

sprite url
sprite exec python -m http.server 8080

Inspect machine state

sprite exec ps aux
sprite exec df -h
sprite exec free -h

Check selection issues

sprite list
sprite use my-sprite

help

sprite --help
sprite exec --help
sprite url --help
sprite checkpoint --help

Advanced References

Read only when needed:

  • Wake-safe services / long-lived HTTP processes: references/services-and-wakeup.md
  • Advanced access, SSHFS mounting, env vars: references/networking-and-access.md

Output Expectations

When using this skill:

  • State which Sprite and org you are targeting.
  • Show concrete commands.
  • Call out persistence, security, or restore implications when relevant.