Skip to main content
The floo CLI is a single static binary (~2MB). Every command supports --json for structured output that agents can parse. Colored output (spinners, tables, progress bars) goes to stderr. JSON data goes to stdout.

​
Output contract

The CLI has two output modes:

​
Human mode (default)

Colored output to stderr. Tables, spinners, success/error messages. Nothing on stdout. 
floo apps list

​
JSON mode (--json)

Structured JSON to stdout. Colored output still goes to stderr. 
floo apps list --json
Success: 
{
  "success": true,
  "data": {
    "apps": [...]
  }
}
Error: 
{
  "success": false,
  "error": {
    "code": "NOT_AUTHENTICATED",
    "message": "Not logged in",
    "suggestion": "Run `floo auth login` to authenticate"
  }
}

​
Agent pattern

Strip stderr, parse stdout: 
floo deploy --json 2>/dev/null | jq '.data.deploy.url'

​
Global flags

FlagDescription
--jsonOutput structured JSON to stdout
--dry-runPreview what a command would do without executing it

​
Dry run

--dry-run previews what a command will do without executing it. Supported on: deploy, env set/remove/import, apps delete, domains add/remove, deploy rollback. 
floo deploy --dry-run --json

​
Configuration

The CLI stores config at ~/.floo/config.json (permissions: 0600): 
{
  "api_key": "floo_...",
  "user_email": "you@example.com",
  "api_url": "https://api.getfloo.com/v1"
}

​
Environment variable override

VariableDescription
FLOO_API_URLOverride the API base URL
FLOO_NO_UPDATE_CHECKDisable automatic update checks

​
Commands

CommandDescription
floo auth loginAuthenticate (opens browser)
floo auth logoutClear stored credentials
floo auth whoamiShow current user
floo auth tokenPrint API key to stdout
floo auth registerCreate a new account
floo auth update-profileUpdate display name
floo initInitialize project config files
floo deployDeploy an app
floo deploy listList deploy history
floo deploy logsShow build logs
floo deploy watchStream deploy progress
floo deploy rollbackRollback to previous deploy
floo apps listList all apps
floo apps statusApp details
floo apps deleteDelete an app
floo apps passwordShow app shared password
floo apps github connectConnect GitHub repo
floo apps github disconnectDisconnect GitHub repo
floo apps github statusGitHub connection status
floo env setSet env var
floo env listList env vars
floo env removeRemove env var
floo env getGet env var value
floo env importImport from .env file
floo services listList services
floo services infoService details
floo services addAdd a service
floo services rmRemove a service
floo domains addAdd custom domain
floo domains listList domains
floo domains removeRemove domain
floo logsView runtime logs
floo releases listList releases
floo releases showRelease details
floo releases promotePromote to production
floo billing usageCurrent usage and plan
floo billing upgradeUpgrade plan
floo billing spend-capManage spend cap
floo orgs members listList org members
floo orgs members set-roleChange member role
floo analyticsTraffic analytics
floo images listList base images
floo skills installInstall agent skill file
floo docsBuilt-in platform documentation
floo commandsList all commands (structured for agents)
floo billing contactEnterprise contact info
floo versionPrint CLI version
floo updateSelf-update the CLI