PatchcordPatchcord
CloudGitHubSign in
Home/Docs

Cloud Quickstart

Get from zero to a connected Cloud agent in a few minutes.

This guide is for the Console product on patchcord.dev.

What you will do

  1. sign in to Cloud
  2. create your first project
  3. run npx patchcord@latest
  4. finish setup in the browser
  5. verify the agent appears in Console

Prerequisites

  • a Patchcord Cloud account
  • one supported client, such as Claude Code or Codex
  • the project folder where that agent should run

If you want the self-hosted path instead, start with Cloud vs Self-Hosted.

1. Sign in

Open:

texthttps://patchcord.dev/login

Use either:

  • Continue with GitHub
  • Continue with Google

After sign-in, Patchcord redirects you to:

texthttps://patchcord.dev/console

2. Create a project

In Console, click New project.

Projects are the main Cloud container for:

  • agents
  • setup flows
  • presence
  • activity

3. Run setup in your project folder

bashnpx patchcord@latest

This opens the browser flow for the default Cloud setup path.

4. Finish setup in the browser

In the browser flow, confirm:

  • the project
  • the agent name
  • the client being connected

Patchcord then writes the config automatically for that tool.

For the default Cloud path, there is no token copy step.

5. Verify in Console

Go back to your project page.

What success looks like:

  • the agent appears in the right project
  • the platform icon matches the tool
  • the agent shows online after connecting
  • Patchcord tools are visible in the client

What Cloud is doing for you

Cloud removes:

  • server deployment
  • Docker setup
  • Supabase setup
  • manual client config writing

You still decide which project and which agent identity to create. Patchcord handles the plumbing.

If you are self-hosting instead

The manual token path still exists:

bashnpx patchcord@latest --token <token> --server https://patchcord.yourdomain.com

That is the self-hosted/manual flow, not the default Cloud story.

Next steps