Configuration Guide

Customize CLIO's behavior and settings

Configuration File

CLIO stores configuration in ~/.clio/config.json. The file is created automatically on first run.

Location

~/.clio/config.json          # User configuration
.clio/instructions.md        # Project-specific instructions (optional)
.clio/ltm.json              # Long-term memory database

Basic Settings

AI Provider Configuration

: /api set provider github_copilot    # Use GitHub Copilot
: /api set provider openai            # Use OpenAI
: /api set provider anthropic         # Use Anthropic Claude
: /api set provider deepseek          # Use DeepSeek
: /api set provider llama.cpp           # Use local llama.cpp
: /api set provider sam               # Use local SAM

: /api set model gpt-4o               # Set specific model
: /api set key YOUR_API_KEY           # Set API key (not needed for GitHub Copilot)

: /config save                        # Save configuration

Display Settings

: /theme                   # Change color theme
: /verbose                 # Toggle verbose output
: /debug                   # Toggle debug mode

Advanced Configuration

Custom Instructions

Create project-specific AI instructions in .clio/instructions.md:

# .clio/instructions.md
This is a Python Django project.
- Always use Django ORM, not raw SQL
- Follow PEP 8 style guide
- Write tests for new features

Session Behavior

Configure session defaults:

  • Max tokens: Control context window size
  • Temperature: Adjust creativity (0.0-1.0)
  • Tool timeout: Set command execution limits

File Exclusions

Create .clioignore to exclude files from searches:

# .clioignore
node_modules/
dist/
*.log
.env

Configuration Commands

Command Description
/config show Display current configuration
/config save Save configuration to disk
/config reset Reset to defaults
/config edit Open config in $EDITOR

Environment Variables

CLIO_API_KEY           # API key for provider
CLIO_MODEL             # Default model
CLIO_PROVIDER          # Default provider
CLIO_SESSION_DIR       # Session storage location
CLIO_CONFIG_DIR        # Configuration directory
EDITOR                 # Text editor for multiline input

Next Steps