flyio
Read and write Fly.io: list apps and machines, manage volumes, start/stop/restart machines, run exec commands. Trigger phrases: fly.io, machines.
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- flyio
- tagline
- List apps and machines, manage machine lifecycle.
- metadata
- { "includeInPrompt": true }
- description
- Read and write Fly.io: list apps and machines, manage volumes, start/stop/restart machines, run exec commands. Trigger phrases: fly.io, machines.
- catalog_auth
- API token (app or org scoped)
- catalog_hosts
- [ "api.machines.dev" ]
02 资源文件 1
- 脚本bin/flyio.py7.0 KB
03 SKILL.md 正文
Fly.io
Purpose
Read and write the user's Fly.io Machines through the Fly.io Machines REST API: list apps and machines, inspect machines and volumes, create machines, stop/start/restart them, and run one-off commands inside a machine with exec. Use when the user mentions Fly.io, fly apps, or their machines.
Tooling
All commands go through bin/flyio.py:
bin/flyio.py auth # verify the API key
bin/flyio.py apps --org personal # list apps in an org
bin/flyio.py machines --app myapp # list machines in an app
bin/flyio.py volumes --app myapp # list volumes in an app
bin/flyio.py machine-create --app myapp --config-json '<config-json>' # create a machine (confirm first)
bin/flyio.py machine-stop --app myapp --id <machine-id> # stop a machine (confirm first)
bin/flyio.py machine-start --app myapp --id <machine-id> # start a machine (confirm first)
bin/flyio.py machine-restart --app myapp --id <machine-id> # restart a machine (confirm first)
bin/flyio.py exec --app myapp --id <machine-id> --command "df -h" # run a command in a machine (confirm first)
--org defaults to personal and is only used for apps. Machine IDs come from machines. This CLI uses the Machines REST API only; the Fly GraphQL endpoint is documented as unstable and is not used here.
Auth
- Provider id:
flyio(credential is collected ascustom.flyio) - Collection: API key via the secure credential flow (
credentials.request_api_access); create one withflyctl auth tokenor in the Fly.io dashboard under Account > Tokens - Allowed hosts:
api.machines.dev - Status check:
bin/flyio.py auth(must return"ok": true)
Operating Rules
machine-create,machine-stop,machine-start, andmachine-restartare writes: confirm the exact action on the exact machine with the user before running, unless standing permission exists. Machine creation also incurs Fly.io usage costs.execruns arbitrary commands inside a machine: confirmation-gated with an explicit warning. Never run destructive commands without the user seeing the exact command string first.- Reading (apps, machines, volumes) needs no confirmation.
- Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the key value.
Files
- SKILL.md
- bin/flyio.py
Maturity
🧪 Draft: written from Fly.io's public API docs; not yet live-tested end-to-end.
04 同仓库更多 Skills
web-scrape
Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open/fetch fails on JS-heavy pages, or when you need clean markdown/structured extraction from a site. Requires FIRECRAWL_API_KEY.
design-taste-frontend
tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML/CSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, "AI-made", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
requesting-code-review
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).