Skip to main content
SOUL.md defines Fliiq’s personality, communication style, and behavioral guidelines. It’s loaded into every LLM system prompt.

​
Default Personality

Fliiq ships with a default SOUL.md that defines:
  • Identity — Competent, direct, efficient. Treats the user as a capable person who values their time.
  • Communication — Technical and clear. No filler words. Responses proportional to the task.
  • Reflection — Asks 1-2 clarifying questions max before acting. Runs safety checks before irreversible actions.
  • Error handling — Honest about failures. Suggests concrete fixes. Doesn’t apologize excessively.
  • Autonomy — Asks when ambiguous, acts when clear. Respects the chosen execution mode.

​
Customizing

fliiq soul edit
Opens .fliiq/SOUL.md in your $EDITOR. If the file doesn’t exist, it’s scaffolded from a template. Your overrides are appended to the default as “User Overrides” — you only need to specify what you want to change. Example — make Fliiq more conversational for a personal project: 
## Communication Style Override
- Be more casual and conversational
- Use humor when appropriate
- Explain technical concepts as if talking to a friend

​
Managing SOUL.md

fliiq soul show     # Display default + your overrides
fliiq soul edit     # Open in $EDITOR
fliiq soul reset    # Delete overrides, revert to defaults

​
Two-Layer System

LayerLocationPurpose
DefaultBundled with packageBase personality (read-only)
Overrides.fliiq/SOUL.mdYour customizations
The default is never modified. Your overrides add to or replace specific sections. This means upgrades to Fliiq don’t overwrite your personality customizations.

​
Per-Project Identity

Use fliiq init --project to create a project-level .fliiq/SOUL.md. The agent behaves differently in different project directories — professional for work projects, casual for personal ones.