Installation
Install Maven 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 Maven releases repository before choosing More info → Run anyway.
Install an agent CLI
Maven 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 Maven.
- 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.
Using Maven at work
If your company uses Maven Admin, you can sign in with your organization to use the AI models it provides, alongside your own. It is optional. See Use Maven at work.
Build from source
Requirements: Node.js 24 or newer, pnpm 10.33.0, and at least one authenticated agent CLI.
git clone https://github.com/Bulalu/maven.git
cd Maven
corepack enable
pnpm install --frozen-lockfileRun the harness, web UI, and Electron shell in separate terminals:
pnpm dev:server
pnpm dev
pnpm dev:desktopWhere data lives
Maven stores its application data under ~/.maven. Electron window and browser data use the normal per-platform application data directory.