commands and docs

Two commands describe the installed CLI, version-matched to the binary, and neither needs authentication. An agent drives floo through this CLI or the HTTP API; the API path starts at getfloo.com/agents.md.

commands

Print the full command tree. With --json it is the machine-readable list of what the installed CLI can do.

floo commands
floo commands --json

JSON output

{
  "success": true,
  "data": {
    "version": "2026.09.01.1",
    "commands": [
      {
        "name": "analytics",
        "usage": "floo analytics [APP]",
        "description": "View traffic analytics for an app or org",
        "requires_auth": true
      }
    ]
  }
}

requires_auth is false for the commands that work before floo auth login, such as auth login, preflight, and docs. version is the installed CLI version. Commands with subcommands carry a nested subcommands array.

# Commands an agent can run before the user has logged in
floo commands --json 2>/dev/null | jq -r '.data.commands[] | select(.requires_auth == false) | .name'

docs

Print the topic index, or resolve one topic to its URL on this site. The CLI carries no offline copy of the docs.

floo docs                  # every topic with a one-line summary
floo docs quickstart       # one topic: summary and URL
floo docs quickstart --json

Arguments

Argument	Description
`TOPIC`	Topic to resolve. Omit for the full index.

JSON output

{
  "success": true,
  "data": {
    "topic": "quickstart",
    "summary": "End-to-end setup and first deploy",
    "url": "https://getfloo.com/docs/introduction",
    "cli_version": "2026.09.01.1",
    "schema_version": 2
  }
}

Without a topic, --json returns topic: "overview", the rendered index as content, and a topics array of {name, summary, aliases, url}. A topic requested by alias adds requested_topic and alias: true. Append .md to any returned URL for the Markdown source, the form to hand an agent.

Discovery order

This order finds the right command in the fewest calls without guessing a flag:

floo commands --json for the capability list.
floo <command> --help for exact arguments and flags.
floo docs <topic> --json for the concept behind the command.

The installed command tree is the source of truth: a command in the binary but not on this site is real; the reverse is not.

CLI overview, the output contract and app inference shared by every command
Agent setup, permissions and the JSON parsing contract

CLI

Config and runtime

Errors

API

commands and docs

commands

JSON output

docs

Arguments

JSON output

Discovery order

​commands

​JSON output

​docs

​Arguments

​JSON output

​Discovery order

​Related

commands

JSON output

docs

Arguments

JSON output

Discovery order

Related