update

version

Check for a newer release, install it if there is one, and print the installed CLI version. In --json mode, or when stdout is not a terminal, it only prints the version.

floo version

Checking for floo updates...
2026.09.01.1
✓ floo 2026.09.01.1 is up to date.

Releases are date-versioned (YYYY.MM.DD, plus a counter for a same-day re-release). When a newer release is available, the final line names both versions: Updated floo from 2026.09.01 to 2026.09.01.1.

floo version can replace the installed binary when it finds a newer release. Set FLOO_NO_UPDATE_CHECK=1 when you only need the current version without a network check or update.

JSON output

{
  "success": true,
  "data": {
    "version": "2026.09.01.1",
    "update_available": null
  }
}

floo version --json skips the update check, so data never carries previous_version.

Update the CLI to the latest release or a specific version.

floo update
floo update --version v2026.09.01.1

floo update mutates the installed binary in place. It downloads the target release and overwrites the file at floo’s current path on disk. There is no automatic rollback: to revert, reinstall the desired version with the installer or download the binary directly. floo update --preflight shows what would be installed without touching the binary.

JSON output

{
  "success": true,
  "data": {
    "version": "2026.09.01.1",
    "path": "/usr/local/bin/floo",
    "refreshed_skills": ["/absolute/path/to/.claude/skills/floo/SKILL.md"]
  }
}

When to use these commands

floo version: update to the latest release and confirm which binary is on a machine
floo update: track the latest shipped CLI or pin a version

CLI

Config and runtime

Errors

API

update

version

JSON output

update

JSON output

When to use these commands

​version

​JSON output

​update

​JSON output

​When to use these commands

version

JSON output

update

JSON output

When to use these commands