# 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

- [Guillermo Rauch](https://x.com/rauchg), Vercel CEO, through his
  [OSS Grants](https://rauchg-oss-grants.vercel.app/) programme.
- [Greptile](https://www.greptile.com/), AI code reviews, free for open source.

[![Greptile: The War on Bugs](https://www.greptile.com/badge.svg)](https://www.greptile.com/?utm_source=oss_badge&utm_medium=readme&utm_campaign=greptile_for_open_source)

Want to sponsor Dray? [drayhq.com/support](https://www.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.

```bash
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:

```bash
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.

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

On Linux the same line makes the machine a Dray server: [drayhq.com/docs/server](https://www.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](THIRD-PARTY-LICENSES.md).

**Themes.** Four palettes are MIT ports, colours theirs and token names ours:
[Catppuccin](https://github.com/catppuccin/catppuccin),
[Cobalt2](https://github.com/wesbos/cobalt2-vscode) (Wes Bos, Roberto Achar),
[One Dark Pro](https://github.com/Binaryify/OneDark-Pro) (Binaryify) and
[gruvbox](https://github.com/morhetz/gruvbox) (Pavel Pertsev).

**Marks.** The [pi](https://pi.dev) 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](https://github.com/handy-computer/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](https://github.com/cjpais/Handy)'s marimba pair, by CJ Pais, MIT.
Handy's name and brand assets are not used here.