Skip to main content

​
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]
OptionDefaultDescription
--modesupervisedExecution mode
--providerautoLLM provider to use
--model, -mprovider defaultModel alias or full model ID
--personaauto-detectActivate a persona/playbook (e.g. product-manager, frontend, coding)
--show-browseroffShow 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]
OptionDefaultDescription
--modeautonomousStarting execution mode
--providerautoLLM provider to use
--model, -mprovider defaultModel alias or full model ID
--personaauto-detectActivate a persona/playbook for the session
--show-browseroffShow 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]
OptionDefaultDescription
--modeautonomousStarting execution mode
--providerautoLLM provider to use
--model, -mprovider defaultModel alias or full model ID
--personaauto-detectActivate a persona/playbook for the session
--show-browseroffShow browser window during web_navigate

​
fliiq init

Initialize Fliiq configuration. 
fliiq init [--project]
OptionDescription
(none)Creates ~/.fliiq/ with .env template
--projectCreates .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
OptionDefaultDescription
-n, --limit20Number of recent audit trails to show
See Audit Trails for the full guide.