Installation

Get Cliio up and running on your Mac in just a few minutes.

System Requirements

  • macOS 11 Big Sur or later
  • 50 MB of free disk space
  • At least one AI CLI installed (Claude Code, Codex, or Gemini)

Installation Methods

Homebrew (Recommended)

Recommended

The easiest way to install Cliio is via Homebrew. This method handles installation, updates, and uninstallation automatically.

1

Install Homebrew (if not already installed)

If you don't have Homebrew installed, run this command in your terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2

Add the Cliio tap

brew tap yourusername/cliio
3

Install Cliio

brew install --cask cliio

That's it! Cliio is now installed in your Applications folder.

Keeping Cliio Updated

To update to the latest version, simply run: brew upgrade cliio

Direct Download

Download the DMG file directly if you prefer manual installation.

1

Download the DMG

Download the latest version from the official website:

Download Cliio.dmg
2

Open the DMG file

Double-click the downloaded Cliio.dmg file to mount it.

3

Drag to Applications

Drag the Cliio app icon to your Applications folder. That's it!

Security Notice

When first opening Cliio, macOS may show a security warning because the app isn't from the App Store. Right-click the app and select "Open" to bypass this one-time warning.

Post-Installation

After installing Cliio, you'll need to have at least one AI CLI tool installed.

Claude Code

npm install -g @anthropic-ai/claude-code

Codex CLI

npm install -g openai-codex-cli

Gemini CLI

npm install -g @google/gemini-cli

Optional: Install tmux for Session Persistence

For the best experience, install tmux to enable session persistence:
brew install tmux

Learn more in the Session Persistence guide.

Next Steps

Now that Cliio is installed, learn how to create your first agent and start coding.

Quick Start Guide