Installation

Download a released build

When releases begin, these are the packages each platform will use:

Neither macOS code signing and notarization nor Windows code signing is set up yet, so the first builds will be unsigned: macOS Gatekeeper and Windows SmartScreen will both warn about them. This page will say plainly which signatures a build carries once builds exist — do not assume one is signed because it came from us.

Install an agent CLI

Dash Bot needs at least one supported agent engine installed and signed in. Claude and Codex are the most common starting points.

1. Install the CLI from its official provider.
2. Run it once in a terminal and complete sign-in.
3. Restart Dash Bot.
4. 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.

Build from source

Requirements: Node.js 24 or newer, pnpm 10.33.0, and at least one authenticated agent CLI.

The repository is private, so the clone below needs a GitHub account with access to it. git reports a private repository as Repository not found rather than as a permissions error — if you see that, ask for access rather than assuming the URL is wrong.

git clone https://github.com/radityabrahmana/DashBot.git
cd DashBot
corepack enable
pnpm install --frozen-lockfile

Run the harness, web UI, and Electron shell in separate terminals:

pnpm dev:server
pnpm dev
pnpm dev:desktop

Where data lives

Dash Bot stores its application data under ~/.dashbot. Electron window and browser data use the normal per-platform application data directory.