Install Aria
The full install plus onboarding takes about 2 minutes.
1. Install the CLI
macOS or Linux:
brew install ariahq/aria/aria2. Sign in
aria loginA browser window opens to connect your account. You only need to do this once per machine.
3. Onboarding prompts
After login, Aria offers a few quick yes/no prompts (defaults are yes, just hit Enter through them):
- Import existing Cursor history? Brings every past Cursor conversation into your account with original timestamps.
- Connect Claude Code? Wires up Claude Code so future sessions sync live.
- Run Aria in the background? Keeps your history synced as you work, even when no terminal is open.
Non-interactive variants: aria login --yes accepts everything; aria login --no-onboarding skips entirely.
4. Verify
aria doctorRuns a quick diagnostic and prints fix suggestions if anything is off.
5. Use it
Three ways to work with Aria, all producing the same searchable history:
- Aria’s own runner:
aria "<prompt>"in any repo. - Claude Code: use
claudeas usual. Everything syncs automatically once Aria is connected. - Cursor: open Cursor and chat as usual. New conversations appear in your dashboard within seconds.
The background daemon
The daemon is what picks up sessions you start from the web composer and keeps Cursor history syncing while you work. If you accepted the onboarding prompts it’s already installed; otherwise:
aria install-daemonIt runs at login from then on. To run it in the foreground instead (for a quick test), use aria daemon. Check its state anytime with aria doctor.
Useful commands
aria whoamishows the signed-in accountaria attach <session-id>opens a read-only view of any session in the terminalaria import-cursorre-syncs Cursor history on demandaria logout
Need help?
Questions, bugs, or feedback: hello@ariacode.dev