Skip to main content
Manage GitHub integration for auto-deploy on push. These are subcommands of floo apps github.

​
connect

Connect a GitHub repo to an app for auto-deploy. Opens browser to install the GitHub App if not already installed. Triggers an initial deploy after connecting. 
floo apps github connect owner/repo --app my-app

​
Flags

FlagDescriptionDefault
--app APPApp name or UUID—
--branch BRANCHBranch to deploy frommain
--skip-env-checkSkip environment variable validation—
--no-deployConnect without triggering an initial deploy—
--no-browserError cleanly if the GitHub App is not installed instead of opening a browser. Required for agents and CI.—

​
Agent / CI usage

In --json mode, --no-browser is implied — the CLI never tries to open a browser. If the Floo GitHub App is not yet installed on the org, connect fails with GITHUB_APP_NOT_INSTALLED and a human needs to install it once from: 
https://github.com/apps/getfloo/installations/new
After install, the agent can retry connect and subsequent pushes deploy automatically.

​
Examples

# 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'

​
JSON output

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

​
disconnect

Disconnect a GitHub repo from an app. 
floo apps github disconnect --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID

​
JSON output

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

​
status

Show GitHub connection status (repo, branch, connected date). 
floo apps github status --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID
GitHub: connected
  Repo:      myorg/my-app
  Branch:    main
  Connected: 2026-02-18 10:30

​
JSON output

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

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
APP_NOT_FOUNDNo app with that name or ID
GITHUB_APP_NOT_INSTALLEDInstall the floo GitHub App first. Browser will open automatically.
GITHUB_REPO_NOT_IN_INSTALLATIONThe GitHub App is installed but does not have access to this repo. Update app permissions in GitHub.
GITHUB_ALREADY_CONNECTEDThis app already has a GitHub repo connected. Disconnect first with floo apps github disconnect.
GITHUB_REPO_NOT_ACCESSIBLECannot access the repo. Check that it exists and you have permission.
GITHUB_NOT_CONNECTEDNo GitHub repo connected. Connect one with floo apps github connect.