Configuration

Customize Cliio to match your workflow and preferences.

Accessing Settings

Open the settings panel in any of these ways:

  • •Press Cmd+, (Command + Comma)
  • •Click Cliio → Preferences in the menu bar
  • •Open the command palette (Cmd+K) and search for "Settings"

CLI Paths

Cliio needs to know where your AI CLI tools are installed. By default, it checks common locations, but you can specify custom paths if needed.

Default Detection

Cliio automatically searches for CLI tools in these locations:

/usr/local/bin/
/opt/homebrew/bin/
~/.npm-global/bin/
~/node_modules/.bin/

Custom Paths

If your CLI tools are installed elsewhere, you can specify custom paths in Settings → CLI Paths:

Claude Code:

/custom/path/to/claude

Codex CLI:

/custom/path/to/codex

Gemini CLI:

/custom/path/to/gemini

Finding Your CLI Path

Not sure where your CLI is installed? Run this command in your terminal:
which claude
# or
which codex
# or
which gemini

Appearance

Customize how Cliio looks to match your preferences.

Theme

Choose between light and dark mode, or use system preferences:

  • •Light - Always use light theme
  • •Dark - Always use dark theme
  • •System - Follow macOS appearance (recommended)

Font Size

Adjust the terminal font size for better readability. Default is 13px.

Cmd+Increase
Cmd-Decrease
Cmd0Reset

Font Family

Choose from popular monospace fonts for the terminal. Options include:

  • SF Mono (default)
  • Menlo
  • Monaco
  • Courier New
  • JetBrains Mono
  • Fira Code

Storage & Sessions

Session Data Location

Cliio stores agent configurations and settings in:

~/Library/Application Support/Cliio/

This includes agent metadata, CLI paths, and user preferences. Terminal session data is managed by tmux and stored separately.

Scrollback Buffer Size

Control how many lines of terminal history are preserved. Default is 10,000 lines. Increase for longer sessions, decrease to save memory.

Very large scrollback buffers (50,000+ lines) can impact performance when restoring sessions.

Auto-Start Agents

Choose whether agents should automatically resume when you open Cliio:

  • •Always - All agents restore automatically (default)
  • •Last Active - Only restore the last used agent
  • •Never - Start fresh each time

Advanced Settings

Environment Variables

Set custom environment variables that will be available in all agent sessions. Useful for API keys, default paths, or custom configurations.

# Example environment variables
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
NODE_ENV=development

Shell Configuration

Choose which shell to use for terminal sessions:

  • •System Default - Use your default shell (recommended)
  • •bash - Bourne Again Shell
  • •zsh - Z Shell (macOS default)
  • •fish - Friendly Interactive Shell

Experimental Features

Some advanced features are marked as "experimental" and may change in future versions. Enable them in Settings → Advanced → Experimental Features.

Resetting Settings

If you need to reset Cliio to default settings:

  1. 1.Quit Cliio completely
  2. 2.Delete the settings file:
rm -rf ~/Library/Application\ Support/Cliio/settings.json

When you restart Cliio, all settings will be reset to defaults. Your agent configurations will remain intact.

Backup First

Consider backing up your settings before resetting:
cp ~/Library/Application\ Support/Cliio/settings.json ~/Desktop/cliio-settings-backup.json

Need Help?

If you're experiencing issues, check out our troubleshooting guide for common problems and solutions.

Troubleshooting Guide