FlightStack CLI - Command Line Interface for Flutter CI/CD

CLI Overview

The FlightStack CLI is your command-line interface for managing build agents, viewing builds, and interacting with FlightStack.

Installation

# macOS (Homebrew)
brew tap voostack/tap && brew install flightstack

# Linux / macOS (curl)
curl -fsSL https://get.flightstack.dev | bash

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/voostack/flightstack-releases/releases/latest/download/flightstack-windows-x64.zip" -OutFile "flightstack.zip"

See the Installation Guide for detailed setup instructions.

Basic Usage

flightstack <command> [subcommand] [options]

Getting Help

# General help
flightstack --help

# Command-specific help
flightstack agent --help
flightstack agent start --help

Available Commands

Authenticate with FlightStack

agent

Manage build agents

logout

Sign out of FlightStack

Command Reference

Command	Description
`flightstack login`	Authenticate with your account
`flightstack logout`	Sign out
`flightstack agent list`	List all agents
`flightstack agent show <id>`	Show agent details
`flightstack agent register`	Register this machine
`flightstack agent start`	Start the agent
`flightstack agent stop`	Stop the agent
`flightstack agent status`	Show local agent status
`flightstack agent install`	Install as startup service
`flightstack agent uninstall`	Remove startup service
`flightstack agent update <id>`	Update agent settings
`flightstack agent delete <id>`	Delete an agent
`flightstack update`	Update CLI to latest version
`flightstack config`	View/modify CLI configuration

Auto-Updates

Both the CLI and build agent support automatic updates.

CLI Auto-Update

Enable automatic updates so you don’t have to manually update:

# Enable auto-update
flightstack config --auto-update true

# Disable auto-update
flightstack config --auto-update false

# Manual update
flightstack update

When auto-update is enabled, the CLI checks for updates once every 24 hours and automatically downloads and applies new versions.

Agent Auto-Update

Agents automatically update between jobs by default. This ensures your remote build agents stay up-to-date without manual intervention.

# Disable auto-update for this session
flightstack-agent start --no-auto-update

# Or disable in config.json:
# "autoUpdate": false

When an agent updates, it exits with code 100 and restarts. If you’re using a process manager (systemd, launchd), configure it to restart on this exit code.

Global Options

Option	Description
`--help`, `-h`	Show help
`--version`, `-v`	Show version

Configuration

CLI configuration is stored at:

macOS/Linux: ~/.flightstack/
Windows: %USERPROFILE%\.flightstack\

Files:

config.json - User authentication
agent.json - Agent registration (if registered)

Next Steps

Authentication - Logging in and out
Agent Commands - Managing build agents