CLI Repository Commands | FlightStack

Repository Commands

Manage repository connections from the terminal with flightstack repo. The command surface uses flags (not subcommands) — pick one action per invocation.

flightstack repo [--list | --available | --show <id> | --connect <github-id> | --disconnect <id> | --sync <id>] [--org <org-id>]

By default flightstack repo lists your connected repositories.

Options

Flag	Alias	Description
--list	-l	List connected repositories (default)
--available	-a	List GitHub repositories available to connect
--show <id>	-s	Show details for a connected repository
--connect <github-id>	-c	Connect a GitHub repository by its numeric GitHub ID
--disconnect <id>		Disconnect a connected repository (prompts for confirmation)
--sync <id>		Resync a connected repository’s branches from GitHub
--org <org-id>	-o	Scope --list to a specific organization

List connected repositories

flightstack repo
# or, explicitly:
flightstack repo --list

Sample output:

Connected Repositories:

flightstack/sample-app
  Branch: main
  ID: 7d2a8c84-b1d7-4d20-8f50-c3ee2ab4c812

acme/mobile
  Branch: develop
  ID: 4a89bcd1-21f5-42cb-9d4e-5e8a0e9a7f1b

Filter by organization:

flightstack repo --list --org acme-org-id

Show available GitHub repositories

flightstack repo --available

Lists every GitHub repository your account (or the installed FlightStack GitHub App) can see. The GitHub ID printed here is the value you pass to --connect.

Available GitHub Repositories:

acme/mobile [private]
  GitHub ID: 487102934

flightstack/sample-app [public]
  GitHub ID: 591240118

To connect: flightstack repo --connect <github-repo-id>

Tip

If this list is empty, install or re-authorize the FlightStack GitHub App for the repositories you want to connect. See the GitHub integration guide.

Show a single repository

flightstack repo --show <repo-id>

Prints name, branches, settings, and the next-step commands (--sync, flightstack workflow, --disconnect).

Connect a repository

flightstack repo --connect <github-repo-id>

<github-repo-id> is the numeric ID from --available (or from the GitHub API). Once connected, the repo appears in your dashboard and is ready for pipelines.

Sync a repository

flightstack repo --sync <repo-id>

Pulls fresh branches and default-branch metadata from GitHub. Use this after creating new branches on GitHub that aren’t yet showing up in pipelines.

Disconnect a repository

flightstack repo --disconnect <repo-id>

You’ll be prompted for confirmation. Disconnecting does not delete your pipelines or run history — it removes the GitHub link.

Next steps

• Pipeline editor to author runs against a connected repo
• Pipeline CLI for linting pipeline YAML and tailing logs
• REST API: repositories for the underlying endpoints