> ## 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.

# CLI Reference

> Complete command reference for the fliiq CLI

## fliiq run

Run a single-shot agent task.

```bash theme={null}
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](/guides/playbooks) (e.g. `product-manager`, `frontend`, `coding`) |
| `--show-browser` | off              | Show browser window during `web_navigate` (headless by default)                                 |

**Examples:**

```bash theme={null}
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`.

```bash theme={null}
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.

```bash theme={null}
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](/guides/playbooks) for the session |
| `--show-browser` | off              | Show browser window during `web_navigate`                        |

## fliiq tui

Start a full-screen TUI session.

```bash theme={null}
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](/guides/playbooks) for the session |
| `--show-browser` | off              | Show browser window during `web_navigate`                        |

## fliiq init

Initialize Fliiq configuration.

```bash theme={null}
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.

```bash theme={null}
fliiq doctor
```

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

## fliiq models

Show available model aliases.

```bash theme={null}
fliiq models
```

Displays all aliases from `~/.fliiq/models.yaml` — both built-in and custom. See [Model Selection](/guides/configuration#model-selection) for details on adding custom aliases.

## fliiq skill-list

List all available skills with their source.

```bash theme={null}
fliiq skill-list
```

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

## fliiq skill-promote

Promote a local skill to core.

```bash theme={null}
fliiq skill-promote <name>
```

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

## fliiq soul

Manage agent identity.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
fliiq google auth                   # Authorize a Google account (Calendar + Gmail)
fliiq google accounts               # List authorized accounts
```

## fliiq telegram

Manage Telegram bot setup.

```bash theme={null}
fliiq telegram setup                # Interactive setup: detects chat ID and saves to .env
```

## fliiq daemon

Manage the background daemon.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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](/guides/audit) for the full guide.