Install DP Code on macOS, Linux, and Windows

DP Code ships as a native desktop app for macOS, Linux, and Windows, and as a Node.js server you can run from source. Both options expose the same web UI and WebSocket API. Choose whichever fits your workflow.

Desktop app
Run from source

The desktop app is the easiest way to run DP Code. It bundles the Node.js server and React web UI into a single Electron application — no runtime dependencies required beyond the AI coding agent CLI you want to use.DownloadGo to the Releases page and download the file for your operating system:

OS	File
macOS (Apple Silicon)	`.dmg` (arm64)
macOS (Intel)	`.dmg` (x64)
Linux	`.AppImage` (x64)
Windows	NSIS installer `.exe` (x64)

macOS

Open the downloaded .dmg file.
Drag DP Code to your Applications folder.
Launch it from Applications or Spotlight.

On first launch, macOS may show a security warning because the app is not yet notarized. Open System Settings → Privacy & Security and click Open Anyway.

Linux

Make the AppImage executable:

chmod +x DP-Code-*.AppImage

Run it:

./DP-Code-*.AppImage

WindowsRun the downloaded .exe installer and follow the setup wizard. DP Code will launch automatically after installation.

Running from source gives you the latest code and lets you modify DP Code itself. You need Bun and Node.js installed before you begin.Prerequisites

Tool	Minimum version
Bun	`^1.3.9`
Node.js	`^24.13.1`

Install dependencies and start the dev serverClone the repository, then run:

bun install

bun run dev

This starts both the Node.js server and the Vite dev server for the web UI. Open the URL printed in your terminal (default: http://localhost:3773) to access the interface.

Do not run bun run dev while another DP Code instance is already using the default port. Use the --port flag or the T3CODE_PORT environment variable to run on a different port.

Start only the server or web UI

# Server only
bun run dev:server

# Web UI only
bun run dev:web

Run the desktop app from source

bun run dev:desktop

Environment variables

Set these before starting the server. CLI flags (see below) take precedence over environment variables when both are set.

Variable	Description	Default
`T3CODE_PORT`	Port for the HTTP/WebSocket server.	Auto-selected (web) or `3773` (desktop)
`T3CODE_HOST`	Host or interface to bind — for example `0.0.0.0` or a Tailnet IP.	`127.0.0.1` in desktop mode
`T3CODE_HOME`	Base directory for all DP Code data (SQLite, logs, sessions).	`~/.dpcode`
`T3CODE_NO_BROWSER`	Set to `1` to disable automatic browser opening on startup.	`false` (web), `true` (desktop)
`T3CODE_AUTH_TOKEN`	Auth token required for WebSocket connections. Leave unset to disable auth.	Unset
`T3CODE_MODE`	Runtime mode: `web` or `desktop`.	`web`
`T3CODE_LOG_PROVIDER_EVENTS`	Set to `1` to emit NDJSON logs for provider events (useful for debugging).	`false`
`T3CODE_LOG_WS_EVENTS`	Set to `1` to emit server-side logs for outbound WebSocket push traffic.	`false`

CLI flags

When running from source you can pass flags directly to the server command. All flags are optional.

bun run dev -- [flags]

Flag	Description
`--port <number>`	Port for the HTTP/WebSocket server (1–65535).
`--host <string>`	Host or interface to bind.
`--home-dir <path>`	Base directory for all DP Code data. Equivalent to `T3CODE_HOME`.
`--mode <web\|desktop>`	Runtime mode. `desktop` applies loopback defaults unless overridden.
`--no-browser`	Disable automatic browser opening.
`--auth-token <string>`	Auth token required for WebSocket connections. Alias: `--token`.
`--dev-url <url>`	Dev web URL to proxy to. Equivalent to `VITE_DEV_SERVER_URL`.

Example: run on a custom port with auth enabled

bun run dev -- --port 8080 --auth-token mysecrettoken --no-browser

Example: isolated instance for development

T3CODE_PORT=58090 T3CODE_NO_BROWSER=1 bun run dev -- --home-dir ./.dpcode-dev --port 58090

If you are running DP Code alongside an existing instance, always use a different --port and --home-dir to avoid conflicts.

Get Started

Core Features

Configuration

Desktop App

Install DP Code on macOS, Linux, and Windows

Environment variables

CLI flags

Build docs developers (and LLMs) love

Get Started

Core Features

Configuration

Desktop App

Documentation Index

​Environment variables

​CLI flags

Build docs developers (and LLMs) love

Environment variables

CLI flags