← Back to Skills Marketplace
aiwithabidi

Flyio

by aiwithabidi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
378
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install flyio
Description
Fly.io edge deployment platform — manage apps, machines, volumes, secrets, and certificates via the Fly.io Machines API. Deploy containers globally, scale to...
README (SKILL.md)

✈️ Fly.io

Fly.io edge deployment platform — manage apps, machines, volumes, secrets, and certificates via the Fly.io Machines API.

Features

  • App management — create, list, configure apps
  • Machine operations — start, stop, restart machines
  • Volume management — persistent storage provisioning
  • Secret management — secure environment secrets
  • Certificate management — SSL/TLS auto-provisioning
  • Scaling — scale machines up/down, auto-stop
  • Region selection — deploy to specific global regions
  • Health checks — monitor machine health
  • Network config — IP allocation, private networking
  • Deployment — rolling deploys with canary support

Requirements

Variable Required Description
FLY_API_TOKEN API key/token for Fly.io

Quick Start

# List apps
python3 {baseDir}/scripts/flyio.py apps --limit 20
# Get app details
python3 {baseDir}/scripts/flyio.py app-get my-app
# Create an app
python3 {baseDir}/scripts/flyio.py app-create '{"app_name":"my-service","org_slug":"personal"}'
# List machines
python3 {baseDir}/scripts/flyio.py machines --app my-app

Commands

apps

List apps.

python3 {baseDir}/scripts/flyio.py apps --limit 20

app-get

Get app details.

python3 {baseDir}/scripts/flyio.py app-get my-app

app-create

Create an app.

python3 {baseDir}/scripts/flyio.py app-create '{"app_name":"my-service","org_slug":"personal"}'

machines

List machines.

python3 {baseDir}/scripts/flyio.py machines --app my-app

machine-get

Get machine details.

python3 {baseDir}/scripts/flyio.py machine-get --app my-app mach_abc123

machine-start

Start a machine.

python3 {baseDir}/scripts/flyio.py machine-start --app my-app mach_abc123

machine-stop

Stop a machine.

python3 {baseDir}/scripts/flyio.py machine-stop --app my-app mach_abc123

machine-create

Create a machine.

python3 {baseDir}/scripts/flyio.py machine-create --app my-app '{"config":{"image":"nginx:latest","guest":{"cpus":1,"memory_mb":256}}}'

volumes

List volumes.

python3 {baseDir}/scripts/flyio.py volumes --app my-app

volume-create

Create a volume.

python3 {baseDir}/scripts/flyio.py volume-create --app my-app '{"name":"data","size_gb":10,"region":"ord"}'

secrets

List secrets.

python3 {baseDir}/scripts/flyio.py secrets --app my-app

secret-set

Set a secret.

python3 {baseDir}/scripts/flyio.py secret-set --app my-app "DATABASE_URL" "postgres://..."

certs

List certificates.

python3 {baseDir}/scripts/flyio.py certs --app my-app

regions

List available regions.

python3 {baseDir}/scripts/flyio.py regions

status

App status overview.

python3 {baseDir}/scripts/flyio.py status --app my-app

Output Format

All commands output JSON by default. Add --human for readable formatted output.

# JSON (default, for programmatic use)
python3 {baseDir}/scripts/flyio.py apps --limit 5

# Human-readable
python3 {baseDir}/scripts/flyio.py apps --limit 5 --human

Script Reference

Script Description
{baseDir}/scripts/flyio.py Main CLI — all Fly.io operations

Data Policy

This skill never stores data locally. All requests go directly to the Fly.io API and results are returned to stdout. Your data stays on Fly.io servers.

Credits


Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation

Usage Guidance
This looks like a mostly legitimate Fly.io CLI wrapper, but take these precautions before installing: - Verify the API endpoint: the script points to https://api.machines.dev/v1 rather than an official Fly.io host. Confirm with the author why a non‑Fly.io domain is used and whether it is an approved proxy/relay. - Note undocumented file access: the script will try to read WORKSPACE or ~/.openclaw/workspace/.env to find FLY_API_TOKEN. If you keep other secrets in a .env file in that location, the script will read that file (it only extracts FLY_API_TOKEN but still accesses the file). If you prefer, set FLY_API_TOKEN explicitly in the environment instead. - Check the skill author and homepage (agxntsix.ai) and confirm trust before providing your token. Use a token with minimal permissions (or a scoped/temporary token) for testing and rotate it afterwards if you decide to trust the skill. - Review the included scripts locally (scripts/flyio.py) yourself — network calls are limited to API_BASE, and there is no obfuscation, but you should be comfortable with the domain being contacted. If the author confirms the API_BASE and you set FLY_API_TOKEN in your environment (not only in an undetermined .env), the skill's behavior would be coherent; otherwise treat it cautiously.
Capability Analysis
Type: OpenClaw Skill Name: flyio Version: 1.0.0 The skill is classified as suspicious due to severe functional bugs in `scripts/flyio.py` related to argument parsing and API path construction. The script fails to correctly process positional arguments (e.g., app names, machine IDs, secret keys/values) as documented in `SKILL.md`, instead relying on a global `--id` flag or hardcoded, often incorrect, API endpoints (e.g., `/app/get` instead of `/apps/{app_name}`). This makes many advertised functionalities non-operational, posing a significant reliability vulnerability for an AI agent. While the skill correctly retrieves the `FLY_API_TOKEN` from environment variables or a specific `.env` file, and there is no evidence of intentional data exfiltration or other malicious behavior, the fundamental flaws in its operation warrant a 'suspicious' classification.
Capability Assessment
Purpose & Capability
Name, description, commands, and required env var (FLY_API_TOKEN) align with a Fly.io CLI wrapper. However the script uses API_BASE = "https://api.machines.dev/v1" (not the expected api.fly.io host) and the declared homepage is agxntsix.ai rather than fly.io, which could indicate a third‑party proxy or misconfiguration and should be verified.
Instruction Scope
SKILL.md states no local data storage and declares no config paths, but the included script will attempt to read a .env file from a workspace path (WORKSPACE or ~/.openclaw/workspace/.env) to extract FLY_API_TOKEN. That file access is not documented in SKILL.md and is outside declared scope.
Install Mechanism
No install spec (instruction-only + included script). The shipped Python script uses only the standard library and nothing is downloaded or written during install, so install risk is low.
Credentials
The skill requests only FLY_API_TOKEN (primary credential), which is appropriate for a Fly.io integration. The script, however, will also consult the WORKSPACE env var and potentially read a local .env file to obtain the token — that additional file access is not declared and means the script will read user config files if present.
Persistence & Privilege
The skill is not marked always:true, does not request system-wide config changes, and does not modify other skills. It runs on invocation only.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install flyio
  3. After installation, invoke the skill by name or use /flyio
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Fly.io skill for edge deployment and management. - Manage Fly.io apps, machines, volumes, secrets, and certificates via the Machines API - Fully CLI-driven, outputs JSON by default, with optional human-readable formatting - No external dependencies; requires only Python 3.10+ and FLY_API_TOKEN environment variable - Supports global container deployment, serverless scaling, persistent storage, and networking configuration - Designed for secure, automated infrastructure management by AI agents
Metadata
Slug flyio
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Flyio?

Fly.io edge deployment platform — manage apps, machines, volumes, secrets, and certificates via the Fly.io Machines API. Deploy containers globally, scale to... It is an AI Agent Skill for Claude Code / OpenClaw, with 378 downloads so far.

How do I install Flyio?

Run "/install flyio" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Flyio free?

Yes, Flyio is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Flyio support?

Flyio is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Flyio?

It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.

💬 Comments