Fly
@jamesakeech/flyv2026.07.01.3
01README
Monitor Fly.io organisations and applications — discover apps, machine/deploy state, volumes, snapshots, events — and take safe volume snapshots, via the Fly Machines API.
02Release Notes
Initial release: Fly.io org + app monitoring (discovery, status, volumes, events, snapshots) and safe volume snapshots.
03Models
@jamesakeech/fly/appv2026.07.01.3fly_app.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| appName | string | Fly app name, e.g. my-app |
| apiToken | string | Fly API token with read access (and volume-snapshot write). Source from a vault. |
| apiBaseUrl | string | Fly Machines API base URL; override only for testing. |
fn status()
List machines and capture deployment state, running image, and health checks
fn volumes()
List the app's volumes (size, region, attachment, retention)
fn events()
Summarize each machine's lifecycle events (starts, exits, OOM kills)
fn snapshots()
List every snapshot across all of the app's volumes
fn snapshot(volumeId?: string)
Create a snapshot of every volume (or a specific volumeId)
| Argument | Type | Description |
|---|---|---|
| volumeId? | string | Snapshot only this volume; omit to snapshot all of the app's volumes |
Resources
status(infinite)— App deployment/runtime status: machines, state, image, checks
volume(infinite)— A Fly volume attached to the app (one record per volume)
snapshot(infinite)— A volume snapshot (one record per snapshot)
snapshotRequest(infinite)— Audit record of the last snapshot-creation request
machineEvents(infinite)— Per-machine lifecycle event summary (starts, exits, OOM kills)
@jamesakeech/fly/orgv2026.07.01.3fly_org.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| orgSlug | string | Fly organization slug, e.g. personal |
| apiToken | string | Fly API token with org read access. Source from a vault. |
| apiBaseUrl | string | Fly Machines API base URL; override only for testing. |
fn apps()
Discover every app in the org (id, machine count, network)
fn status()
Fan out over every app in the org and summarize its machine state
Resources
app(infinite)— An app discovered in the org (one record per app)
appStatus(infinite)— Per-app machine-state summary (one record per app)
04Stats
A
100 / 100
Downloads
3
Archive size
14.9 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms