Skip to main content

​
One-line install

curl -fsSL https://getfloo.com/install.sh | bash
The installer detects your OS and architecture (macOS/Linux, x86_64/arm64), downloads the correct binary, and installs to /usr/local/bin/floo. The binary is ~2MB. No runtime dependencies. No Docker. No Node.js.

​
Verify

floo version

floo 0.2.0

​
Authenticate

floo auth login
This opens your browser for device code authentication. Your API key is stored at ~/.floo/config.json with 0600 permissions. 
floo auth whoami

✓ Logged in as you@example.com (key: floo_abc1...ef23)

​
Update

floo update
Downloads and replaces the binary in-place. Or with Homebrew: 
brew upgrade floo

​
Uninstall

rm /usr/local/bin/floo
rm -rf ~/.floo
Or with Homebrew: 
brew uninstall floo

​
For agents

Install and authenticate in one block: 
curl -fsSL https://getfloo.com/install.sh | bash
floo auth login --api-key YOUR_API_KEY
Verify with JSON output: 
floo auth whoami --json

{
  "success": true,
  "data": {
    "email": "you@example.com",
    "api_key": "floo_abc1...ef23"
  }
}

Next: Configuration

Understand floo.app.toml and floo.service.toml.