github

floo apps github connect owner/repo --app my-app

https://github.com/apps/getfloo/installations/new

# Connect a repo (triggers initial deploy)
floo apps github connect myorg/my-app --app my-app

# Connect a specific branch
floo apps github connect myorg/my-app --app my-app --branch develop

# Connect without deploying
floo apps github connect myorg/my-app --app my-app --no-deploy

# Agent / CI: fail cleanly if the GitHub App is not installed
floo apps github connect myorg/my-app --app my-app --no-browser

# Agent workflow: connect and extract status (--json implies --no-browser)
floo apps github connect myorg/my-app --app my-app --json 2>/dev/null | jq -r '.data.status'

{
  "success": true,
  "data": {
    "repo_full_name": "myorg/my-app",
    "default_branch": "main",
    "status": "connected",
    "deploy_triggered": true
  }
}

floo apps github disconnect --app my-app

{
  "success": true,
  "data": {
    "app": "my-app",
    "status": "disconnected"
  }
}

floo apps github status --app my-app

GitHub: connected
  Repo:      myorg/my-app
  Branch:    main
  Connected: 2026-02-18 10:30

{
  "success": true,
  "data": {
    "repo_full_name": "myorg/my-app",
    "default_branch": "main",
    "status": "connected",
    "connected_at": "2026-02-18T10:30:00Z"
  }
}