Skip to main content

​
Prerequisites

​
Install

​
Initialize

This creates ~/.fliiq/ with a .env template. Open it and paste your API key:
.env
At least one LLM API key is required. If multiple are set, Fliiq uses Anthropic first, then OpenAI, then Gemini. Use --provider to choose a specific provider:
See Configuration for persistent defaults and self-hosted LLM setup.

​
Verify Setup

doctor checks your API keys, SOUL.md, playbooks, MCP servers, and skill directories. Fix any issues it reports before continuing.

​
Run Something

Fliiq spins up an agent loop, selects the right tools (get_current_time, write_file, shell), executes them, and returns results.

​
Start an Interactive Session

This launches the REPL where you can have multi-turn conversations. The agent remembers context within the session. For a full-screen TUI, use fliiq tui.

​
Commands

​
Execution Modes

Fliiq has three execution modes that control how much autonomy the agent has:

​
What Just Happened?

When you ran a command, Fliiq:
  1. Loaded your API key and initialized the LLM provider
  2. Assembled a system prompt (SOUL.md + mode instructions + available skills)
  3. Entered the agent loop — the model picks tools, executes them, evaluates results, and continues until done
  4. Saved an audit trail to ~/.fliiq/audit/

​
Next Steps

Configuration

Set up Gmail, Twilio, Telegram, and other integrations.

Execution Modes

Understand plan, supervised, and autonomous modes in depth.

Skills

Browse the 57 built-in skills and learn how to create your own.

Daemon & Jobs

Set up scheduled automations that run in the background.