Get set up

Quickstart for members

From your invite to your first session: join your org, install the desktop app, connect a harness you already use and start a session.

Last updated November 16, 2026View as Markdown

This page takes you from the invite in your inbox to a running session in one of your repos. You need an invite from your org and a harness you already use, such as Claude Code or Codex.

EasyCode is invite-only. If you have no invite, ask an admin of your org to send one. Admins start with the Quickstart for org admins.

Join your org

Open the invite

Open the link in your invite email. The page shows Join Northwind and says who invited you and in which role, for example Lena invited you to join Northwind as a member.

Sign in

Click Sign in to accept. Use the email address the invite went to. You can:

  • Enter your email and click Email me a sign-in link. The link works once and expires in 10 minutes.
  • Or click Continue with GitHub, Continue with Google or Continue with Microsoft, when your org has that option.

Accept

Back on the invite, click Accept. You land on your org's home page. If you signed in with the wrong account, click Use another account first.

An invite that no longer works

An invite can expire, be revoked or be used up. The page then says so. Ask the person who invited you for a new one.

Install the desktop app

Sessions run on your own machine, so you need the desktop app. The web app shows your org but runs no harness.

Download it

In the web app, click Get the desktop app at the bottom of the left rail. The Download EasyCode page offers the build for your system first. It has builds for macOS, Windows and Linux.

Install and open it

Install it as you would any app. The desktop app has the steps per system, including how to open a build marked Unsigned.

Sign in

The app asks you to sign in to see your org. Click Sign in with your browser. Your browser opens on Sign in a device? and the app shows a code. Check that both show the same code, type its last four characters in the field, then click Approve. The app finishes signing in on its own and opens your org.

Connect a harness you already use

EasyCode drives your harness on your own login. It never reads or copies that login.

Install the harness if you haven't

Install it the way its vendor says. Each harness has its own page under Harnesses on your own login, with the sign-in command and the versions EasyCode is tested with.

Check it in Settings

Open Settings → Harnesses in the desktop app. A harness you are signed in to shows as connected. For one that isn't, click Connect: EasyCode runs the harness's own sign-in command in a terminal, and you sign in with the vendor.

Start your first session

Open a new session

Choose New session in the EasyCode menu in your menu bar or system tray, or click New session at the top of the sessions sidebar.

Pick how it runs

Under the message box:

  • Chat or Terminal. Chat shows the conversation in EasyCode; Terminal is the harness's own interactive terminal.
  • Harness: the one you connected. A harness that isn't ready here is greyed out with Not set up here · open the setup steps.
  • Working directory: the repo folder the harness works in.
  • Product: in an org session, the product this work belongs to. Pick No product when none fits.

Describe the task

Type what you want done, for example Add a CSV export to the Globex orders page, and click Start session. You can also type / to pick a command or skill your org shares.

Your session runs on your machine. In an org, your teammates see it under Sessions in the left rail. Mark it Private and it stays in that list, but its transcript and changes aren't shared. A session in your Personal space stays on your machine. Security and privacy lists what an org session shares.

Next

Something wrong or missing? Suggest a change

On this page