Skip to main content
Manage your deployed apps.

​
list

List all apps on your account. 
floo apps list

Your apps:
  Name          Status  Runtime   URL
  my-app        live    nodejs    https://my-app-abc123.run.app
  api-service   live    python    https://api-service-def456.run.app
  landing       stopped static    https://landing-ghi789.run.app

​
Flags

FlagDescriptionDefault
--page NPage number1
--per-page NResults per page50

​
JSON output

{
  "success": true,
  "data": {
    "apps": [
      {
        "id": "a1b2c3d4-...",
        "name": "my-app",
        "status": "live",
        "url": "https://my-app-abc123.run.app",
        "runtime": "nodejs",
        "created_at": "2026-02-18T10:30:00Z"
      }
    ]
  }
}

​
status

Show details for a specific app. Accepts app name or UUID. 
floo apps status my-app

App: my-app
  Status:   live
  URL:      https://my-app-abc123.us-central1.run.app
  Runtime:  nodejs (Next.js)
  Created:  2026-02-18 10:30

​
JSON output

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-...",
    "name": "my-app",
    "status": "live",
    "url": "https://my-app-abc123.us-central1.run.app",
    "runtime": "nodejs",
    "created_at": "2026-02-18T10:30:00Z"
  }
}

​
delete

Delete an app and tear down its infrastructure. 
floo apps delete my-app

Delete my-app? This cannot be undone. [y/N] y
Deleted my-app

​
Flags

FlagDescription
--forceSkip confirmation prompt

​
JSON output

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-..."
  }
}

​
password

Show the shared password for a password-protected app. 
floo apps password my-app

​
github

Manage GitHub integration for auto-deploy on push. See the full reference at GitHub Integration. 
floo apps github connect owner/repo --app my-app
floo apps github disconnect --app my-app
floo apps github status --app my-app

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
APP_NOT_FOUNDNo app with that name or ID. Check with floo apps list