CLI Reference

fliiq run

Run a single-shot agent task.

fliiq run <prompt> [--mode autonomous|supervised|plan] [--provider anthropic|openai|gemini] [--model <alias>] [--persona <name>] [--show-browser]

Option	Default	Description
`--mode`	`supervised`	Execution mode
`--provider`	auto	LLM provider to use
`--model`, `-m`	provider default	Model alias or full model ID
`--persona`	auto-detect	Activate a persona/playbook (e.g. `product-manager`, `frontend`, `coding`)
`--show-browser`	off	Show browser window during `web_navigate` (headless by default)

Examples:

fliiq run "what time is it"
fliiq run "build a Flask todo app" --mode autonomous
fliiq run "refactor the auth module" --mode plan
fliiq run "summarize this repo" --provider openai
fliiq run "complex task" --model opus-4.6
fliiq run "task" -m gpt-4.1
fliiq run "write a PRD for onboarding" --persona product-manager
fliiq run "find info on example.com" --show-browser

fliiq plan

Shortcut for fliiq run --mode plan.

fliiq plan <prompt> [--provider anthropic|openai|gemini] [--model <alias>] [--persona <name>]

fliiq (REPL)

Start an interactive REPL session. This is the default command when no subcommand is given.

fliiq [--mode autonomous|supervised|plan] [--provider anthropic|openai|gemini] [--model <alias>] [--persona <name>] [--show-browser]

Option	Default	Description
`--mode`	`autonomous`	Starting execution mode
`--provider`	auto	LLM provider to use
`--model`, `-m`	provider default	Model alias or full model ID
`--persona`	auto-detect	Activate a persona/playbook for the session
`--show-browser`	off	Show browser window during `web_navigate`

fliiq tui

Start a full-screen TUI session.

fliiq tui [--mode autonomous|supervised|plan] [--provider anthropic|openai|gemini] [--model <alias>] [--persona <name>] [--show-browser]

Option	Default	Description
`--mode`	`autonomous`	Starting execution mode
`--provider`	auto	LLM provider to use
`--model`, `-m`	provider default	Model alias or full model ID
`--persona`	auto-detect	Activate a persona/playbook for the session
`--show-browser`	off	Show browser window during `web_navigate`

fliiq init

Initialize Fliiq configuration.

fliiq init [--project]

Option	Description
(none)	Creates `~/.fliiq/` with `.env` template
`--project`	Creates `.fliiq/` in current directory with SOUL.md, playbooks, mcp.json

fliiq doctor

Verify your setup.

fliiq doctor

Checks: API keys, SOUL.md, playbooks, MCP servers, skill directories.

fliiq models

Show available model aliases.

fliiq models

Displays all aliases from ~/.fliiq/models.yaml — both built-in and custom. See Model Selection for details on adding custom aliases.

fliiq skill-list

List all available skills with their source.

fliiq skill-list

Output shows each skill’s name, source (core or local), and description.

fliiq skill-promote

Promote a local skill to core.

fliiq skill-promote <name>

Moves from .fliiq/skills/<name>/ to skills/core/<name>/. Validates all 3 files exist.

fliiq soul

Manage agent identity.

fliiq soul show       # Display default + overrides
fliiq soul edit       # Open .fliiq/SOUL.md in $EDITOR
fliiq soul reset      # Delete overrides, revert to defaults

fliiq playbook

Manage domain playbooks.

fliiq playbook list                 # List all playbooks with source
fliiq playbook show <name>          # Display a playbook's content
fliiq playbook create <name>        # Scaffold a new custom playbook

fliiq mcp

Manage MCP server connections.

fliiq mcp add <name> --command <cmd> --args <args>    # Stdio transport
fliiq mcp add <name> --url <url>                       # HTTP transport
fliiq mcp list                                         # List servers
fliiq mcp test [name]                                  # Validate connections
fliiq mcp remove <name>                                # Remove a server

fliiq google

Manage Google account authorization.

fliiq google auth                   # Authorize a Google account (Calendar + Gmail)
fliiq google accounts               # List authorized accounts

fliiq telegram

Manage Telegram bot setup.

fliiq telegram setup                # Interactive setup: detects chat ID and saves to .env

fliiq daemon

Manage the background daemon.

fliiq daemon start [--detach]       # Start daemon (optionally in background)
fliiq daemon stop                   # Graceful shutdown
fliiq daemon status                 # Check if running, show Telegram status
fliiq daemon restart                # Stop + start

fliiq job

Manage scheduled jobs.

fliiq job list                      # All jobs with status, next/last run
fliiq job create                    # Interactive job creation wizard
fliiq job run <name>                # Manual trigger (runs immediately)
fliiq job logs <name>               # Recent run history
fliiq job output <name>             # Full response from last run
fliiq job delete <name>             # Remove a job

fliiq audit

Browse and inspect agent audit trails. Every run — REPL, TUI, single-shot, or scheduled job — produces an audit trail capturing model, token usage, tool calls, and timing.

fliiq audit list                    # Tabular view of recent runs (time, ID, prompt, tokens, model)
fliiq audit list -n 50              # Show more entries (default: 20)
fliiq audit show <id>               # Full detail for a specific run

Option	Default	Description
`-n`, `--limit`	`20`	Number of recent audit trails to show

See Audit Trails for the full guide.

​fliiq run

​fliiq plan

​fliiq (REPL)

​fliiq tui

​fliiq init

​fliiq doctor

​fliiq models

​fliiq skill-list

​fliiq skill-promote

​fliiq soul

​fliiq playbook

​fliiq mcp

​fliiq google

​fliiq telegram

​fliiq daemon

​fliiq job

​fliiq audit