Get started
Install Aetox
Four ways in. Pick one channel and stay with it — the Store build and the installer build keep separate settings, chats and keys.
Pick a channel
| Channel | Who it is for | Updates |
|---|---|---|
| Microsoft Store | Most people. Signed by Microsoft, so Windows installs it without a warning. | Windows updates it |
| Installer | You want the newest build the day it ships. | In the app: Download the update → Restart to update |
| CLI | You want the code desk in a terminal, sharing the app's keys and memory. | Runs beside the app; per user, no admin rights |
| Scoop | You already keep your tools in Scoop. | scoop update aetox |
Microsoft StoreOr open the Store page and press Install.
winget install --id=9N4KKBRRSCZZ --source=msstoreInstallerDownloads aetox-amd64-installer.exe from the latest release.
https://github.com/Mikedev115/Aetox-Harness/releases/latest/download/aetox-amd64-installer.exeCLIA separate program that drives the same engine from a terminal.
https://github.com/Mikedev115/Aetox-Harness/releases/latest/download/aetox-cli-setup.exeScoopInstalls from the manifest in the public repository.
scoop install https://raw.githubusercontent.com/Mikedev115/Aetox-Harness/main/scoop/aetox.jsonWhat it needs
- Windows, 64-bit. Linux and macOS are ports in progress and PLATFORM-SUPPORT.md says exactly how far each one is.
- A model to talk to — an account, an API key, or LM Studio / Ollama on the same machine. Nothing else is required to start.
- Disk — the installer is about 49 MB; the app keeps its chats, its database and its logs under your Windows profile.
Where it keeps things
- Settings, keys, chat database
%APPDATA%\Aetox—aetox.db(SQLite) and one JSON file per setting group- Logs
%APPDATA%\Aetox\logs—engine.logand one log per launch- Your skills
%USERPROFILE%\.aetox\skills\<name>\SKILL.md- Files it makes without a project
%USERPROFILE%\aetox\output\<session>
Nothing in that list leaves the machine. Chat history, keys and generated files are yours to copy, back up or delete.
Uninstall
Remove it the way you installed it — Settings › Apps › Installed apps for the Store or installer build, scoop uninstall aetox for Scoop — then delete %APPDATA%\Aetox if you want the chats and keys gone too. Uninstalling the app does not delete that folder by itself; keeping it is what makes a reinstall pick up where you left off.