Skip to content
monorepo-labsPublic

Repository files navigation

Dray

A desktop home for your coding agents. Dray wraps coding-agent CLIs (Claude Code, Codex, pi, fx, Grok) in a native chat UI. Run many sessions at once. Each gets its own worktree, diff view, PR panel, issue panel and embedded browser.

Sponsors

Greptile: The War on Bugs

Want to sponsor Dray? drayhq.com/support

Layout

Path What
apps/desktop The Tauri app. React 19 + Vite frontend, Rust backend.
apps/web Marketing site. Next.js, deployed to Vercel.
apps/docs Docs at drayhq.com/docs. Blume, deployed to Vercel.
apps/ios iPhone and iPad client of a Dray server. SwiftUI.
apps/island Dray Island, the Mac companion panel. SwiftUI.
apps/cli The dray CLI agents use to fan work out.
crates/dray-proto Wire types shared by the CLI and the app.

Getting started

You need Node with pnpm, a Rust toolchain, and cmake.

pnpm install
pnpm app    # desktop app
pnpm web    # marketing site on :3000
pnpm test   # frontend tests

Everything else runs from the package's own directory:

cd apps/desktop && pnpm tauri build
cd apps/desktop/src-tauri && cargo test

cargo test regenerates apps/desktop/src/types/events.ts. Always follow a filtered run with a bare cargo test.

The dray CLI

A standalone binary. It talks to the running app over ~/.dray/dray.sock, so an agent in one session can create, list and message others.

curl -fsSL https://www.drayhq.com/install.sh | sh

On Linux the same line makes the machine a Dray server: drayhq.com/docs/server.

Releasing

App: tag vX.Y.Z (stable) or vX.Y.Z-beta.N (beta). The tag must match apps/desktop/src-tauri/tauri.conf.json, and a stable release needs a matching section in apps/desktop/CHANGELOG.md.

CLI: tag cli-vX.Y.Z (stable) or cli-vX.Y.Z-beta.N (beta), matching the version in apps/cli/Cargo.toml exactly. Cut one beside every app release, beta included, so a server can run the core that release expects.

Credits

Full licence texts are in THIRD-PARTY-LICENSES.md.

Themes. Four palettes are MIT ports, colours theirs and token names ours: Catppuccin, Cobalt2 (Wes Bos, Roberto Achar), One Dark Pro (Binaryify) and gruvbox (Pavel Pertsev).

Marks. The pi mark is MIT, © Earendil Inc. & Contributors. Claude's and OpenAI's are their owners' trademarks and only name the agent a session runs on.

Transcription. Dictation runs locally on transcribe.cpp (MIT). Models are handy-computer's GGUF conversions from Hugging Face, CC-BY-4.0 with their base models' terms. The dictation sounds are Handy's marimba pair, by CJ Pais, MIT. Handy's name and brand assets are not used here.

Releases

Sponsor this project

Packages

Contributors

Languages