25. Uninstall and data cleanup
- Delete the app: macOS — drag to Trash; Windows — Control Panel; Linux — package manager or delete the AppImage.
- Wipe data: Settings → Data → Data directory → Open, close the app, then delete the directory. Destroys all sessions, skills and credentials — use with care.
- Disable auto-start: before uninstall, turn it off in Settings → General to avoid stray launch entries.
- Revoke the plan quota: signing out makes this machine unable to use the plan quota; the account itself remains in the management backend.
25.1 Close a workspace and clear its data
The workspace right-click menu's "Close project workspace and clear data…" cleans everything up in one go when you're done with a project. The dialog is split by where the data lives, and you clear whichever group you tick:
Local data (the app data directory; project files untouched):
| Option | What it removes |
|---|---|
| Sessions and message records | Session YAML/JSONL, drafts, stashes, subagent output |
| Workspace config | Hooks, zMCP, tools, agents, messaging bindings |
Attachments attachments/ |
Screenshots, logs, oversized pastes |
Samples samples/ |
The sec.* tools' sample sandbox |
| Other leftovers | .DS_Store, remnants of older versions and other unrecognised entries |
| Remove from the recent list | "Forget" the workspace; all local records go |
The project directory (the workspace's own self-managed data; local workspaces only):
| Option | What it removes |
|---|---|
Project state .avlcode/ |
Memories, ontology, indexes, plans, output caches (keeps config plus skills / agents) |
| Project files (dangerous) | Wipes the project directory down to avlcode.yaml; you can optionally keep .git and keep samples |
| All workspace files (dangerous) | Wipes .git too, leaving an empty directory |
- Each dangerous option requires its own separate "I understand" acknowledgement, and the dialog spells out exactly what will be permanently deleted and what is kept.
- Ticking a broader option auto-selects and locks the narrower options it covers, so nothing is missed and nothing is cleaned twice.
- The dialog also offers "Clear and reopen" — clear, then immediately reopen a clean workspace. This used to clear only local data and leave the project directory alone, so the old
.avlcode/was still there after "clear and reopen"; that gap is now closed. - SSH / remote workspaces don't offer this action (see §4.4.2 for why) — use the ordinary "Close project workspace" instead (remote files are unaffected); to also delete the local record, go to Settings → Recent and click "Delete record".