Frequently Asked Questions

Bots, agents, subscriptions and where your data lives.

Bots

What is a bot?

A bot is one ongoing chat that runs your coding tasks. Tell it what you want and it starts a task for each piece of work, keeps track of them all, and tells you how they went. Each task is its own agent session in its own git worktree, kept out of your sidebar.

Do I have to set one up?

No. Dray comes with Dray Bot, ready to chat. To make another, click New bot in the sidebar and pick a name, a face, and the agent and model it runs on. Tell it its job in your first message and it writes that down itself.

Which repos can a bot work in?

Any of them. A bot belongs to no project. It picks the repo for each task, even one you never added to Dray, and can start a task on another of your machines.

How does my message reach the right task?

The bot reads it and passes it on to the task it is about, with the context that task needs. To name a task yourself, type & in the bot's chat and pick one of its active tasks.

How do I know what my tasks are doing?

Every task reports back to the bot when its turn ends. Dray sends that report, not the agent, so a task can't forget to. The bot then tells you what matters, in a line or two, and stays quiet when nothing needs you.

What shows up as waiting on me?

A task that has sat for five minutes on a question for you, and a pull request ready to merge. They show at the foot of the bot's chat, and Dray sends a desktop notification when the window is in the background. Failing checks, merge conflicts and requested changes go to the bot instead, which has the task fix them.

How do I merge a task's pull request?

When GitHub says the pull request is ready, a merge card appears in the bot's chat. Merge from it and Dray merges the pull request, settles the task and deletes its worktree. The same Merge button sits on the task's row in the Tasks tab.

Do tasks' questions and permission requests reach me?

Yes. When a task asks you something or wants permission to run a tool, the card comes to you in the bot's chat, so you answer without leaving it.

Can I look inside a task?

Yes. Click it in the side panel's Tasks tab, or on the line where the bot started it, and it opens as a tab next to the bot's chat with its own transcript, composer, diff, files and browser.

Does a bot remember how I work?

Yes. A bot saves what it learns, such as your preferences, decisions, people and where things live, as notes in its own folder, and reads them when they matter. Its AGENTS.md holds its job and your rules, and the agent it runs on loads that file every session. Dray commits that folder to a local git history after every turn, so nothing the bot overwrites is lost.

Can I switch a bot to another agent?

Yes, between turns. Pick another agent in the bot's model picker and your next message moves the chat over. The new agent is handed the conversation so far, and the tasks already running carry on.

Can I have more than one bot?

Yes. Make one per job, such as one for ops and one for a side project. Bots can message each other: type @ in a bot's chat to name another one.

Can I still run sessions without a bot?

Yes. Start a session from the sidebar and drive the agent yourself, as before.

Agents and subscriptions

Which agents does Dray support?

Claude Code, Codex, pi, fx and Grok Build. Each session and each bot picks its own agent and model, so you can run several side by side.

Compare the agents
Do I need a new subscription or API key?

No. Bring your own. Dray runs each agent's own CLI, signed in the way you already use it, so your work runs on the subscription or key that agent already has. Dray stores no agent login and charges nothing.

Is Dray safe to use with my Claude subscription?

Yes. Dray runs Anthropic's own Claude Code CLI so it works within their terms.

Does Dray install the agents for me?

No. Install each agent the way its maker says. If one is missing, Dray's agent picker marks it and gives you the command to install it.

Install an agent

Machines and privacy

Does Dray send my code off my machine?

No. Your sessions, transcripts and bot notes stay on your machine, and your agents talk to their own providers, as usual. Dray sends a few anonymous usage events, never your prompts or code, and DRAY_NO_ANALYTICS turns them off.

What Dray sends
Do my sessions keep running when I quit Dray?

Yes. On a Mac your sessions run in a background server, so quitting the app leaves them working. Choose Quit completely to stop them too.

Can I run agents on my other machines?

Yes. Install the Dray server on a Linux box or another Mac and add it in Dray. Its sessions show in the same sidebar, and a bot can send tasks there.

Set up a server
Does Dray run on Linux?

Yes. The Linux app is in beta: a .deb for Debian and Ubuntu, or an AppImage for other distros with glibc 2.35 or newer, on x64 and arm64. Dray also runs as a server on a Linux box, driven from the app on another machine.

Download for Linux

General

What is Dray?

Dray is a Mac app for coding agents. Talk to one bot that runs many tasks for you, or drive sessions yourself, on your Mac or on your other machines.

Is Dray free?

Yes. Dray is free and open source under Apache 2.0.

What do I need to run it?

A Mac on macOS 11 or later, or Linux on x64 or arm64 (in beta), and at least one of the supported agents installed and signed in.

Your subscription, your favourite harness. Mix and switch freely.

On your devices

Download the app.

On a server

Install the CLI.

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