ThreadGrid
Sign inDownload

Quickstart

Your first finished job

Install ThreadGrid, connect one agent, and have it make a change in one of your projects. It takes about ten minutes.

Before you start

  • A Mac with Apple Silicon on macOS 13 or later, or a Windows 10 or 11 PC (x64).
  • At least one agent: Claude (a Pro or Max plan), Codex (a ChatGPT plan), or OpenCode, whose free models need no account.
  • A project folder. A git repository works best.
  • On Windows: Git for Windows.

Steps

  1. Download and install ThreadGrid

    Get the installer from the download page.

    • Mac: open the DMG and drag ThreadGrid to Applications. It's signed and notarized, so it opens without a warning.
    • Windows: run ThreadGrid-beta-x64-setup.exe. It installs for your user only, so you don't need admin rights. The installer isn't code-signed yet, so Windows shows "Windows protected your PC". Choose More info → Run anyway.

  2. Sign in to one agent in a terminal

    ThreadGrid runs each agent's own CLI with your login. Install one and sign in:

    # Claude
claude auth login

# or Codex
codex login

# or OpenCode
opencode auth login

    Install steps for each are in Set up your agents.

  3. Open ThreadGrid and check the Get set up card

    The Get set up card lists each agent. You want at least one to say Ready. If one says Sign in:, it shows the command to run. Press ⌘J (Ctrl+J on Windows) to open a terminal inside ThreadGrid and run it there.

  4. Add a project folder

    Click Add folder… on the card, or the + next to Projects in the sidebar, and choose your project.

  5. Describe the outcome

    Press ⌘N (Ctrl+N) for a new thread. Type what you want done, for example "Add a --verbose flag to the CLI and a test for it", and press Enter.

    ThreadGrid picks an agent and shows why. The agent works on a new branch in its own git worktree, so your current checkout isn't touched.

  6. Answer approvals

    Edits and most commands inside the thread's worktree run without asking. Pushes and other protected actions show an approval card. Choose Approve or Deny. Each approval covers that one exact action.

  7. Review the result

    When the thread finishes, read the changes in the thread. The work is on the thread's branch: merge it the way you normally would. To ask for more, type a follow-up in the same thread.

Optional: sign in to ThreadGrid. Local work doesn't need an account. Sign in (Settings → Account) to pair another computer or your iPhone.

Next

  • Try Fusion for a change that should be tested and reviewed before you see it.
  • Add a second agent, so ThreadGrid can route around one that's running low.
  • On Windows, turn on Keep this PC awake and Start ThreadGrid when I sign in in Settings → Power if you want to send it work from your Mac. See Computer to computer.