// Install guide

Install Aiola. Ready for the work.

Choose the right build, connect one of your agent CLIs, and open your first project.

Also for Intel Mac. Also available for macOS. Free download · 7-day trial.

macOS 11 or later · Windows 10 or later (64-bit)

Aiola
Monitor
Tools
Recents
Aiola logo

What should we work on today?

|
Friday, 16 October 2026
10:00
11:00
12:00
13:00
14:00
15:00
16:00
17:00
Fix auto-PR worktree collision
Error sweep across workspaces
Review onboarding copy
11:20
Upcoming this week

Needs attention

Fix these so Aiola keeps sending complete data to Aiola.

Analytics snippet not detected on /pricing
Add the snippet so visits on that page are counted.

// Download

Download the right build

Get Aiola from the download page. Direct links point to GitHub Releases.

macOS

macOS — Apple Silicon

M1/M2/M3/M4 Macs. File:
Aiola-arm64.dmg

macOS

macOS — Intel

older Intel Macs. File:
Aiola-x64.dmg

Windows

Windows

Windows 10 or later, 64-bit. File:
Aiola.exe

(NSIS installer)

Aiola is a desktop app only — it does not run on phones. See the mobile companion waitlist for future iOS/Android support.

// macOS

Install on macOS

Step 1

Open the downloaded .dmg file.

Step 2

Drag Aiola into your Applications folder.

Step 3

Eject the disk image and launch Aiola from Applications.

Gatekeeper on first open. macOS may say the app was downloaded from the internet. Aiola is notarized with hardened runtime. If macOS blocks launch, go to System Settings → Privacy & Security and click Open Anyway, or right-click Aiola in Applications and choose Open once to confirm.

Auto-updates. After install, Aiola checks GitHub Releases periodically and downloads updates in the background. Restart when prompted to run the latest notarized build.

// Windows

Install on Windows

Step 1

Run the downloaded Aiola.exe installer.

Step 2

Follow the NSIS setup wizard (install location, shortcuts).

Step 3

Launch Aiola from the Start menu or desktop shortcut.

SmartScreen "unrecognized app." Windows may show a blue SmartScreen dialog for publishers that are new to your machine — even when the installer is properly code-signed. This usually improves as more users install the same certificate. If you downloaded from aiola.app or our official GitHub Releases link, click More info, then Run anyway. Do not install Aiola from unofficial mirrors.

Auto-updates. The app uses electron-updater against GitHub Releases, same as macOS. Updates download silently and ask you to restart.

// First run

First-run setup

After install, Aiola walks you through a short onboarding sequence:

Step 1

Sign in

Google OAuth or email one-time passcode. No Aiola password.

Step 2

Install and connect a CLI

You need at least one coding agent. Install the CLI, then authenticate:

Claude Code:

claude login

Codex:

codex login

Cursor Agent:

cursor-agent login

Grok CLI:

grok agent --reauth

OpenCode (the open-source coding agent): install with

curl -fsSL https://opencode.ai/install | bash

then run

opencode auth login

Step 3

Open a workspace

Point Aiola at an existing repo folder or clone a project.

Step 4

Start a thread

Open your first agent session and send a prompt.

Aiola orchestrates the CLIs already on your machine. You bring your own Anthropic, OpenAI, Cursor, xAI, or OpenCode-connected model access — there is no API-key markup.

// Works with

Sign in once. Work with the CLIs you already use.

Claude Code
Codex
Cursor
Grok CLI
OpenCode

// Troubleshooting

Still stuck?

See security & trust for signing and data-boundary details. Reach us on support or [email protected].

Return to download if you need a different architecture build.

// Facts

What are Aiola's current CLI and GUI Lifetime facts?

Aiola supports five agent CLIs: Claude Code, Codex, Cursor, Grok CLI (including grok-4.5), and OpenCode.

GUI Lifetime is available now at launch pricing: first 10 customers $49, next 30 $89, then $129. One-time payment.

GUI Lifetime includes the agent orchestrator GUI only; it does not include hosted analytics, app logs, feedback, or other hosted operations pages.

Your code and repos stay on your machine. Agent prompts and file context are sent only to the AI provider you choose — Anthropic (Claude Code), OpenAI (Codex), Cursor, xAI (Grok CLI), or whichever provider you configure in OpenCode — under your own subscription. Aiola never proxies, stores, or resells your code or model traffic. Threads, tasks, notes, and automations are stored locally (SQLite + plain files in your repo). If you use the optional analytics/logs/feedback layer for your shipped products, that telemetry is ingested via Aiola's cloud (Supabase/Tinybird). Offline: agent orchestration UI works offline; running agents requires provider access; GUI Lifetime keeps the local app opening even if Aiola's servers are unreachable.

// FAQ

Which macOS download should I pick — Apple Silicon or Intel?+

If your Mac has an M1, M2, M3, or M4 chip, download the Apple Silicon build. If it is an older Intel Mac, download the Intel build. Aiola requires macOS 11.0 Big Sur or later.

Why does macOS say Aiola cannot be opened?+

macOS Gatekeeper may ask you to confirm opening an app downloaded from the web the first time. Aiola is notarized with hardened runtime. Open System Settings → Privacy & Security and click Open Anyway if prompted, or right-click the app and choose Open once.

Why does Windows SmartScreen warn about Aiola?+

SmartScreen may show an 'unrecognized app' warning for new publishers while the code-signing certificate builds reputation. Aiola's Windows installer is a signed NSIS package. Click More info, then Run anyway if you downloaded from aiola.app or our GitHub Releases link.

How do Aiola updates work?+

The desktop app checks GitHub Releases automatically (about every six hours), downloads updates in the background, and prompts you to restart. You can also download manually from the download page anytime.

Which CLI login commands does Aiola need?+

Install at least one supported agent CLI, then authenticate: claude login (Claude Code), codex login (Codex), cursor-agent login (Cursor), grok agent --reauth (Grok CLI), or opencode auth login (OpenCode). Aiola detects installed binaries and surfaces the right command in setup.

What happens on first run?+

Sign in with Google or email OTP, complete onboarding, connect a CLI, then open or clone a workspace. Start a thread to launch your first agent session.

// Related

Download Aiola for MacOSWindows

One desktop app for Claude Code, Codex, Cursor, Grok CLI, and OpenCode. Free download, bring your own subscriptions.