Docs / Getting started

Getting started

Clioloop installs in one line and connects to the Omni Loop Portal with a single browser approval — no API keys to copy. You'll be looping in under a minute.

1 · Install

macOS, Linux & Termux — one command installs the CLI, terminal UI and desktop app:

curl -fsSL https://raw.githubusercontent.com/Clioloop/Clioloop-agent/main/scripts/install.sh | bash

Windows — install from PowerShell, or download the GUI installer Clioloop-Setup.exe:

iex (irm https://raw.githubusercontent.com/Clioloop/Clioloop-agent/main/scripts/install.ps1)
The Windows installer isn't code-signed yet, so SmartScreen may warn "Windows protected your PC." That's expected and harmless — click More info → Run anyway. Everything is open source and auditable on GitHub.

2 · Connect

Run the setup wizard and choose Omni Loop Portal:

clio setup
# → choose "Omni Loop Portal — one login, 300+ models"

What happens next (an RFC 8628 device-code flow):

  1. Your browser opens this portal with a short device code like WXYZ-2345. No browser on this machine? The terminal prints a URL you can open on any device.
  2. Log in or sign up, check the code matches your terminal, and click Approve.
  3. The CLI receives its tokens automatically and shows the model picker — choose a default and you're connected.

Prefer your own provider keys? The wizard can also store keys for Anthropic, OpenAI, Google and others — but the Portal is the no-key path.

3 · Your first loop

Start an interactive session:

clio

Then try a few in-session commands:

  • /help — list every command in your build
  • /model — switch model or provider without restarting
  • /goal build me a CLI todo app and test it — start an autonomous loop

Where to next

Getting started — install & connect Clioloop · Clioloop