Uninstall

Take Aria out of your agents' settings while it is still installed. It removes only its own entries, and saves a backup of a hook file before changing it.

1. Open the Agents tab and click the hook status at the top. In Answer requests from the notch, click Disconnect next to Claude Code and next to Codex.

2. If you connected Team agent tools: gear menu, Connections, Team, then Remove next to Claude Code and Codex.

3. If you have a hosted account, delete it from the Team tab first (see Account and billing below).

   Restart any agent sessions that are running; they read their settings when they start.

1. Quit Aria: gear menu, Quit Aria. Or in Terminal:

   osascript -e 'quit app "Aria"'

2. Move the app to the Trash:

   mv /Applications/Aria.app ~/.Trash/

3. Move Aria's data folder to the Trash. It holds everything Aria saved: clipboard history, shelf files, caught windows, replay timelines, the briefing history, the search index, setup progress, the hook script and the worktrees Aria made for agent races and workspaces.

   mv ~/Library/Application\ Support/AriaNotch ~/.Trash/

4. Delete Aria's preferences:

   defaults delete app.aria.notch

5. Delete Aria's Keychain items (API keys, sign-in session, Friends pairing, connected services, the Cursor key for session capture). macOS may ask you to allow each one.

   for s in app.aria.notch app.aria.notch.presence app.aria.notch.personal-connectors app.aria.notch.supabase.mkkxrrcqukxalagjsktt.supabase.co com.aria.capture.cursor-cloud.v1; do while security delete-generic-password -s "$s" >/dev/null 2>&1; do :; done; done

   Encrypted room device keys use a service that starts with app.aria.notch.room-device. followed by an id. Find them in Keychain Access by searching for app.aria.notch.

6. Optional: forget the permissions you gave Aria (Accessibility, Screen Recording, Microphone and the rest):

   tccutil reset All app.aria.notch

Aria's hook entries then point at a script that no longer exists. Check which files still have them:

Then edit each file it prints, by hand, with the agent closed:

• ~/.claude/settings.json: under "hooks", Aria added one group to each of SessionStart, SessionEnd, UserPromptSubmit, PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest, Notification, Stop, StopFailure and SubagentStop. Each group is {"hooks": [{"type": "command", "command": "'…/AriaNotch/agents/aria-notch-hook.sh'", "timeout": 10}]} (330 for PermissionRequest). Delete every hook whose command contains aria-notch-hook, then any group or event list left empty, then "hooks" itself if it is empty.
• ~/.codex/hooks.json: the same, for SessionStart, SessionEnd, UserPromptSubmit, PreToolUse, PostToolUse, PermissionRequest and Stop. The command ends in aria-notch-hook.sh' codex.
• ~/.claude.json: delete the "aria-team" member of "mcpServers".
• ~/.codex/config.toml: delete the [mcp_servers.aria-team] block, up to the next line that starts with [.

Next to each file is a backup Aria saved just before each change, named like settings.json.aria-backup-20261104-153000 (for the Team entries, .claude.json.aria-backup-20261104153000). A backup also undoes anything you or the agent changed after it, so editing is usually safer than restoring.

With hooks connected, Aria keeps replay snapshots as private refs under refs/aria/; workspaces add checkpoints there too. They do not touch your branches, index or files. To remove them, run this inside each repository an agent worked in:

Agent races and workspaces ran in git worktrees inside Aria's data folder, on branches named aria/…. After the data folder is gone, tidy the repository's worktree list and see which of those branches remain:

Delete a branch you no longer want with git branch -D and its name. Aria never deleted or merged them for you.

• The *.aria-backup-* files next to your agent settings. Aria never deletes them; remove them when you no longer want them.
• Your agents' own logs (~/.claude/projects, ~/.codex/sessions, ~/.gemini/tmp, ~/.cursor/projects, ~/.copilot/session-state). The agents wrote them; Aria only read them.
• The refs/aria/ refs and aria/… branches in your repositories, until you run the commands above.
• Calendar events and reminders that Aria created when you approved an action. They are ordinary events and reminders now.
• A hosted account and team records, until you delete the account.
• Keychain items from the older Voice Aria app (service com.aria.agent). This app only reads them if you ask it to copy your speech keys, and never deletes them.
• Temporary sockets in /tmp named aria-…. macOS clears them when you restart.
• A login item, only if you added one yourself in System Settings, General, Login Items. Aria's code does not add one.
• Caches that macOS or the update framework may keep under ~/Library/Caches/app.aria.notch and ~/Library/HTTPStorages/app.aria.notch. Aria's code does not name these; move them to the Trash if they exist.

The full list of what Aria reads and writes is on What Aria reads.