Install Aria

The full install plus onboarding takes about 2 minutes.

1. Install the CLI

macOS or Linux:

brew install taladari/aria/aria

2. Sign in

aria login

A 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):

  1. Import existing Cursor history? Brings every past Cursor conversation into your account with original timestamps.
  2. Connect Claude Code? Wires up Claude Code so future sessions sync live.
  3. 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 doctor

Runs 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 claude as 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 whoami shows the signed-in account
  • aria attach <session-id> opens a read-only view of any session in the terminal
  • aria import-cursor re-syncs Cursor history on demand
  • aria logout

Need help?

Questions, bugs, or feedback: tal0392@gmail.com