Skip to main content
Claude Code can build your app and deploy it to floo in a single conversation. No browser, no dashboard, no copy-pasting URLs.

​
Setup

  1. Install floo and authenticate:
curl -fsSL https://getfloo.com/install.sh | bash
floo auth login
  1. Add the floo skill to your project so Claude knows every command:
floo skills install --path .claude/skills/floo
This writes the skill file and prints recommended permissions for .claude/settings.json.

​
Workflow

Tell Claude what you want to build. It writes the code, initializes the project, connects GitHub, and deploys: 
You: Build me a FastAPI app with a /health endpoint and deploy it to floo

Claude: I'll create the FastAPI app and deploy it.
  [creates main.py, requirements.txt]
  [runs: floo init my-app --json]
  [runs: floo apps github connect owner/repo --app my-app]
  [runs: floo deploy --json]

✓ Live at https://my-app-abc123.us-central1.run.app
Claude can also manage the app after deployment: 
You: Set the DATABASE_URL env var and check the logs

Claude:
  [runs: floo env set DATABASE_URL=postgres://... --app my-app]
  [runs: floo logs --app my-app --tail 20 --json]

Here are the recent logs: ...

​
What Claude can do with floo

TaskCommand Claude runs
Initialize projectfloo init my-app --json
Connect GitHubfloo apps github connect owner/repo --app my-app --json
Deployfloo deploy --json
Check statusfloo apps status my-app --json
Set env varsfloo env set KEY=value --app my-app --json
View logsfloo logs --app my-app --json --error
Add domainfloo domains add myapp.com --app my-app --json
Rollbackfloo deploy rollback my-app <deploy-id> --json --force
View analyticsfloo analytics my-app --json
Debug errorsParses error.code and error.suggestion from JSON
Every command returns structured JSON. Claude parses the output and takes the next action automatically.

​
Tips

  • Always use --json — Claude parses JSON output. The --json flag sends structured data to stdout and keeps colored output on stderr.
  • Use --force for destructive commands — Skips confirmation prompts that would block the agent.
  • Pipe with 2>/dev/null — Strips spinner/color output: floo deploy --json 2>/dev/null
  • Use --dry-run — Preview deploys without executing: floo deploy --dry-run --json