Install Aria
The full install plus onboarding takes about 2 minutes.
1. Install the CLI
macOS or Linux:
brew install taladari/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.
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: tal0392@gmail.com