CLI Commands

Overview

Complete reference for all Flaio CLI commands. Run any command with --help for usage details.

flaio

Launch the terminal UI. Opens a full-screen interface with tabbed session management.

flaio

Flag	Description
--help	Show help
--version	Show the CLI version

flaio login

Authenticate with the Flaio platform. Opens a browser window for OAuth.

flaio login

After login, the relay is automatically enabled for remote session access.

flaio logout

Sign out and remove stored credentials. Disables remote relay access.

flaio logout

flaio status

Display CLI status including version, login state, relay connection, hook installation, and available updates.

flaio status

flaio portal

Connect to running Flaio sessions from another terminal window. See Portal for full details.

flaio portal [sessionId]

Flag	Description
-l, --list	Display a table of active sessions

flaio settings

View current settings as formatted JSON (auth tokens are masked).

flaio settings

flaio settings set <key> <value>

Update a setting. Use dot notation for nested keys.

flaio settings set ui.showCost true
flaio settings set ui.sidebarWidth 30
flaio settings set relay.autoConnect false

Values are auto-parsed: true/false become booleans, numeric strings become numbers, null becomes null.

Protected keys (read-only): relay.authToken, relay.refreshToken.

flaio setup-hooks

Install IPC hook scripts for Claude Code and Gemini CLI integration.

flaio setup-hooks

Flag	Description
--claude-only	Configure only Claude Code hooks
--gemini-only	Configure only Gemini CLI hooks
--check	Check if hooks are already configured

Hook scripts are installed to ~/.config/flaio/hooks/ and configuration is merged into the respective agent settings files.

flaio tickets

Manage worktickets. Requires authentication (flaio login).

flaio tickets list

List tickets with optional filters.

flaio tickets list
flaio tickets list --column in_progress --limit 10
flaio tickets list --search "auth bug" --json

Flag	Description
-c, --column <column>	Filter by column (backlog, planning, in_progress, etc.)
-s, --search <term>	Search in title and description
-l, --limit <number>	Max results (default: 20)
--json	Output raw JSON

flaio tickets get <id>

View ticket details including title, column, agent, model, branch, PR URL, description, plan, and deliverables.

flaio tickets get <id>
flaio tickets get <id> --json

flaio tickets update <id>

Update ticket fields.

flaio tickets update <id> --column in_progress --title "New title"

Flag	Description
--title <title>	Set ticket title
--description <desc>	Set description
--column <column>	Move to column
--plan <plan>	Set plan text
--cwd <path>	Set working directory
--agent <agent>	Set agent driver (claude, gemini)
--model <model>	Set model
--implementation-details <details>	Set implementation details
--json	Output updated ticket as JSON