Install

Pre-built binaries for every desktop OS land on the Releases page. Pick the one for your platform:

Platform	File	Notes
macOS (Intel + Apple Silicon)	Tokori_x.y.z_universal.dmg	Universal binary — runs natively on both architectures.
Windows 10 / 11	Tokori_x.y.z_x64_en-US.msi	64-bit installer.
Linux (any modern distro)	tokori_x.y.z_amd64.AppImage	Portable; chmod +x and run.
Debian / Ubuntu	tokori_x.y.z_amd64.deb	sudo apt install ./tokori_*.deb

macOS — first launch

The current binaries aren't yet signed, so macOS will refuse to open the .dmg on first try.

Right-click bypass

1. Mount the .dmg.
2. Right-click Tokori in /Applications → Open.
3. Click Open in the warning dialog.

Subsequent launches work normally.

Terminal bypass

sudo xattr -d com.apple.quarantine /Applications/Tokori.app

Removes the quarantine flag macOS sets on un-notarised downloads.

Code-signing is on the roadmap — once it lands, this dance goes away.

Windows — SmartScreen warning

The unsigned .msi triggers SmartScreen. Click More info → Run anyway.

Linux — AppImage

chmod +x tokori_*.AppImage
./tokori_*.AppImage

Fully portable — no install step. If you want it in your desktop launcher, use AppImageLauncher.

Where data lives

Your workspaces, vocabulary, and chat history are stored in a local SQLite file under your platform's app-data directory:

OS	Path
Linux	~/.config/ai.tokori.desktop/tokori.db
macOS	~/Library/Application Support/ai.tokori.desktop/tokori.db
Windows	%APPDATA%/ai.tokori.desktop/tokori.db

Back this file up if you care about your data — it's the entire app state, portable across machines (same OS) by copy-paste.

Uninstall

• macOS: drag Tokori.app to the Trash; optionally remove ~/Library/Application Support/ai.tokori.desktop/.
• Windows: Settings → Apps → Tokori → Uninstall.
• Linux (.deb): sudo apt remove tokori.
• Linux (AppImage): delete the file.

The data dir isn't removed by uninstall — delete it manually if you want a clean slate.