Installation

Installation

Quick install (recommended)

curl -fsSL https://clido.ai/install.sh | sh

This detects your OS and architecture, downloads the latest release binary, and installs it to ~/.local/bin.

Options:

# Install a specific version
CLIDO_VERSION=v0.1.0 curl -fsSL https://clido.ai/install.sh | sh

# Install to a custom directory
CLIDO_DIR=/usr/local/bin curl -fsSL https://clido.ai/install.sh | sh

Supported platforms: macOS (arm64, x86_64), Linux (x86_64, aarch64)

Build from source

Requires Rust 1.94+ (rustup.rs).

git clone https://github.com/clido-ai/clido-cli.git
cd clido-cli
cargo install --path crates/clido-cli --locked

Verify the installation

clido --version

Expected output:

clido 0.1.0

Check that all required tools and configuration are present:

clido doctor

✓ Binary: clido 0.1.0
✓ API key: ANTHROPIC_API_KEY is set
✓ Config: ~/.config/clido/config.toml
✓ Session dir: ~/.local/share/clido/sessions
✓ Bash: /bin/bash
✓ All checks passed.

If any check fails, doctor will explain what to do. See the First Run guide for full setup details.

Platform notes

macOS

Fully supported on macOS 12+. The --sandbox flag uses sandbox-exec when available.

Linux

Fully supported. The --sandbox flag uses bwrap (bubblewrap) when available. Install bubblewrap for sandboxed Bash execution:

# Debian / Ubuntu
sudo apt install bubblewrap

# Fedora / RHEL
sudo dnf install bubblewrap

Windows

Windows is not currently supported. WSL2 with Ubuntu is a viable workaround.

Shell completions

Generate completion scripts for your shell:

# Bash
clido completions bash >> ~/.bash_completion

# Zsh (add to ~/.zshrc)
clido completions zsh > "${fpath[1]}/_clido"

# Fish
clido completions fish > ~/.config/fish/completions/clido.fish

Man page

Generate and install the man page:

clido man > /usr/local/share/man/man1/clido.1
man clido

Updating

Pull the latest changes and reinstall:

cd clido-cli
git pull
cargo install --path crates/clido-cli --force

Next steps

• Quick Start — run your first prompt
• First Run — configure a provider and API key
• Configuration — full config reference