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 (Scoop)
scoop bucket add voostack https://github.com/voostack/scoop-bucket
scoop install flightstack

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

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