Installation
Download Dices, check system requirements, launch it for the first time, and learn where your data lives.
This page walks you through downloading Dices, the supported platforms and requirements, what happens on first launch, where your data is stored, and how updates work.
Download
Dices ships as a native desktop app for Windows, macOS, and Linux.
Note: Download links go live with the first public release. During the current alpha, grab the build from the channel you were invited through. Dices is free during alpha.
| Platform | Installer |
|---|---|
| Windows | .exe installer |
| macOS | .dmg (Apple Silicon and Intel) |
| Linux | AppImage |
Supported operating systems
- Windows 10 and 11 (64-bit)
- macOS (Apple Silicon and Intel)
- Linux (most modern 64-bit distributions via AppImage)
System requirements
Dices is an Electron desktop app, so the app itself is lightweight — most of the heavy lifting is done by the coding agent you connect.
| Requirement | Recommendation |
|---|---|
| RAM | 8 GB minimum, 16 GB comfortable |
| Disk | A few hundred MB for the app, plus space for your projects and git worktrees |
| Network | An internet connection to reach your agent’s API |
| Git | Installed and on your PATH (Dices runs chats in isolated git worktrees) |
You’ll also need at least one agent connected before you can do real work:
- Claude — your own Anthropic API key (created at console.anthropic.com, billed to you, stored encrypted).
- Google Gemini — the official Gemini CLI installed, plus a
GEMINI_API_KEY. - Other ACP agents (OpenAI Codex, Cursor, Hermes, Pi) — their official vendor CLI installed, where you sign in.
Note: Dices never handles your provider credentials beyond your own API key — Claude uses your Anthropic API key; other agents authenticate in their own official CLI.
See the Quickstart for connecting an agent step by step.
First launch
- Install and open Dices. On Windows, run the
.exe; on macOS, drag the app from the.dmgto Applications; on Linux, make the AppImage executable and run it. - Approve OS prompts if your operating system asks about a new application from a new developer.
- Open Settings with ⌘, / Ctrl , and add your own Anthropic API key (create one at console.anthropic.com). It’s stored encrypted.
- Add a folder (project) to the sidebar so you have somewhere for an agent to work.
- Start your first chat with ⌘N / Ctrl N.
Tip: Press ⌘/ / Ctrl / any time to open the shortcuts sheet, and ⌘K / Ctrl K for the command palette / search.
Where your data is stored
Everything Dices needs lives on your machine — your code never routes through a Dices-hosted server.
- Sessions and chat history are stored in a local SQLite database, so your work persists across restarts.
- Your code lives in the real folders you add, and chats typically run inside an isolated git worktree of that folder.
- Authentication: your own Anthropic API key is saved in Settings (encrypted at rest); other agents authenticate in their own official CLI, and Gemini reads a
GEMINI_API_KEYfrom your environment.
Warning: Because chats run in git worktrees, deleting a session can also clean up its worktree. Commit or merge any work you want to keep before deleting a chat. See The Cockpit for how delete + worktree cleanup behaves.
Updating
Dices is updated by installing the latest build for your platform. During alpha, update through the same channel you received your first build; once releases are public, download the newest installer from the download page. Your SQLite history and your project folders are untouched by updates.
Next steps
- Quickstart — connect an agent and ship your first build.
- The Cockpit — learn the sidebar and the Groups → Folders → Chats hierarchy.