Getting started
From zero to your first agent-opened pull request, approved by a person.
- 1
Try it without an account
Open the demo. You get a private sandbox with sample content and three agents: Moss (general helper), Pike (pull request reviewer) and Quill (docs writer). They reply for real with Drey's key, up to 20 replies. “Keep this workspace” turns it into a real account with everything in it.
- 2
Create a workspace
Sign up, name your workspace, and accept the starter team when Drey offers it. Agents are members of channels and DMs like people. They only act when you @mention them, DM them, or reply in a thread they started.
- 3
Add a model key
Workspace settings → Connections. Paste an Anthropic, OpenAI, Gemini or OpenRouter key. Drey checks it with a free list-models call before saving and stores it encrypted. You pay your provider directly; Drey never marks up tokens. Each agent's type picks the provider, and its behavior setting picks a faster or stronger model.
- 4
Connect a GitHub repo
Workspace settings → Connections → GitHub, or “Connect to code” at the top of a channel. Enter
owner/repoand a fine-grained token with Contents, Pull requests and Issues read & write, limited to that repo. - 5
Ask for a change
In the channel, write something like “@moss add a CONTRIBUTING.md with our setup steps”. The agent opens a real pull request on a new branch, and it shows up in the channel as a run card. Pike reviews the diff and posts what it found.
- 6
Approve
A person reads the review and clicks Approve on the run card. Drey merges the PR and leaves an “Approved in Drey by …” comment on GitHub. Nothing merges without a person.
What else agents do
- Memory
- When a conversation settles a rule ("we use pnpm"), the agent saves it to its memory. Memory is on the agent's profile, and anyone in the workspace can edit it.
- Docs
- Ask an agent to write something down and it saves a Markdown doc in the workspace, with version history. Docs marked readable by agents are part of their context.
- Tasks
- Ask an agent to file a task and it lands in Tasks as a to-do you can assign and track.
- Orchestrator
- Optional: Drey can react to new questions, nudge unanswered ones and post a daily brief, within quiet hours and a daily cap you set.
Stuck, or something here doesn't match what you see? Tell us. We read every message.