Skip to main content

​
Prerequisites

​
Install

pip install fliiq

​
Initialize

fliiq init
This creates ~/.fliiq/ with a .env template. Open it and paste your API key:
.env
ANTHROPIC_API_KEY=sk-ant-...
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: 
fliiq --provider openai
See Configuration for persistent defaults and self-hosted LLM setup.

​
Verify Setup

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

​
Run Something

# Single-shot command
fliiq run "what time is it in Tokyo"

# Build something
fliiq run "create a Python script that generates the first 20 fibonacci numbers"
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

fliiq
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

CommandAction
/modeCycle mode (plan → supervised → autonomous)
/statusShow session info
/clearReset conversation history
/helpShow available commands
/exitExit chat

​
Execution Modes

Fliiq has three execution modes that control how much autonomy the agent has:
ModeBehavior
PlanAgent creates a plan, waits for your approval before executing
SupervisedAgent executes step-by-step, pausing at each tool call for approval
AutonomousAgent executes fully without interruption
fliiq run "refactor the auth module" --mode plan
fliiq --mode supervised

​
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 54 built-in skills and learn how to create your own.

Daemon & Jobs

Set up scheduled automations that run in the background.