Documentation Index
Fetch the complete documentation index at: https://docs.fliiq.ai/llms.txt
Use this file to discover all available pages before exploring further.
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.
| 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.
Checks: API keys, SOUL.md, playbooks, MCP servers, skill directories.
fliiq models
Show available model aliases.
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.
Output shows each skill’s name, source (core or local), and description.
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.