Getting started

From a request to your first thread.

Request access, run the guided setup on your Mac, and send your first message to an agent in a folder you choose.

What you need

  • One Apple silicon Mac (M1 or later). Keep it awake while you want work to run.
  • Your own Claude subscription. The setup asks you to sign in to Claude Code. If you also use Codex, mention it in your request so we can help with its setup.
  • The current customer offer runs on one Mac. Phone access and adding other machines are not currently available with this offer. Linux source builds are limited to invited collaborators.

Request access

Patch is opening to a small group first, so the first step is to ask.

  1. Fill in the Request access form: your name, your email and what you’d use Patch for.
  2. We read every request, and we’ll email you when there’s a place for you.
  3. When your request is accepted, we’ll send you what you need to install Patch.
  4. If you’d rather not do the install yourself, say so in your request, and we’ll set Patch up with you.

There is no public download. The steps below start once your request is accepted.

Install Patch

Open the copy of Patch we send you and choose Run Patch on this Mac.

  1. Follow the setup screen. It lists any missing software and helps install it. If Claude Code needs a sign-in, Patch opens the Claude sign-in page in your browser.
  2. Paste the license key we sent you and select Set up Patch. The app opens its Viewer signed in.
  3. Read and accept the Risk Notice before sending work to an agent. Your Mac contacts Patch to activate the license. See the Privacy Policy for details.

Start your first thread

A conversation in Patch is bound to a folder on your Mac. The Viewer calls that a project. Patch’s configuration files and its older docs call it a channel.

Create a project

  1. Make an empty folder on your Mac for this first run, for example ~/projects/first-turn. Use its full path in the Workspace field below, or choose it with Browse. With an empty folder, whatever appears in it next is plainly the agent’s work.
  2. In the Viewer’s sidebar, press the + next to Projects. It is labeled New project.
  3. Fill in the dialog:
    • Machine: your Mac.
    • Workspace: the folder, as a full path that starts with /. A path that starts with ~ is not accepted. Browse… lets you pick the folder on your Mac.
    • Adapter: claude.
    • Name (optional): what to call it in the list.
  4. Press Create project. It appears in the list.

Send your first message

Open the project, type a message in the box at the bottom and send it. For example:

Create a file called hello.txt in this folder, containing one sentence saying what today’s date is and that you wrote this. Then tell me exactly what you wrote.

While the agent works, the conversation shows what it is doing: thinking, reading, writing a file. Then the reply arrives, and hello.txt is in your folder. Send a follow-up and it carries on the same conversation.

Open another thread

A thread is a second conversation in the same project and the same folder. Press New thread in the project’s title bar, give it a Title and press Create thread.

Before you connect anything

An agent in Patch runs as you, with your permissions, and is not confined to the folder you point it at. It does not stop to ask before it changes or deletes a file, runs a command, sends a message, or acts in an account you have connected, and it can do this on a schedule, with no one watching. Agents make mistakes, and they can be misled by instructions hidden in a page, email or file they read.

So give a project only the folders, tools and accounts you would hand, unsupervised, to someone you trust with your computer while you are signed in. Keep backups of anything you cannot lose. If you use a hub token to sign in to the Viewer in your browser, guard it like a password. Anyone with the token can direct your agents. The full terms are in section 8 of the Terms of Service.

Start with step one.

Patch is opening to a small group first. Tell us what you’d use it for, and we’ll email you when there’s a place for you.

Request access

One Apple silicon Mac · Claude Code sign-in with your own subscription · Codex optional

The current customer offer runs on one Mac. Phone access and adding other machines are not currently available with this offer. Linux source builds are limited to invited collaborators.