Getting started
Installation
Install Brainwrite on macOS, Windows, or Ubuntu.
Download a released build
Choose your computer below. Each link always downloads the latest published build.
| Platform | Recommended package | Notes |
|---|---|---|
| macOS Apple silicon | Download .dmg | Signed and notarized. Drag to Applications. |
| macOS Intel | Download .dmg | Signed and notarized. |
| Windows x64 | Download installer | Per-user installer; Windows signing is not yet available. |
| Ubuntu 24.04 x64 | Download .deb · AppImage | The .deb is recommended; the AppImage is portable. |
Windows SmartScreen
The Windows installer is not code-signed yet. Windows may show “Unknown publisher.” Verify that you downloaded it from the official Brainwrite releases repository before choosing More info → Run anyway.
Install an agent CLI
Brainwrite needs at least one supported agent engine installed and signed in. Claude and Codex are the most common starting points.
- Install the CLI from its official provider.
- Run it once in a terminal and complete sign-in.
- Restart Brainwrite.
- Open the model picker. Available engines appear normally; unavailable engines explain what is missing.
See Agent engines for the complete list and explicit path overrides.
Where data lives
Brainwrite stores its application data under ~/.brainwrite. Electron window and browser data use the normal per-platform application data directory.