Quickstart

From zero to a team of agents

Five steps, about five minutes. At the end you have an orchestrator handing out jobs to Claude Code, Codex or Gemini agents on one board, and you can answer them from your phone.

What you need

  • Windows 10 or 11, macOS 12 or later, or Linux.
  • At least one agent CLI you're already logged in to: Claude Code, Codex CLI, Gemini CLI, Grok Build or OpenCode. GridHive uses your own subscription login; no API keys.
  • For npx gridhive: Node 20 or later. The desktop app needs nothing else.

1Install GridHive

Pick the desktop app (tray icon, notifications, auto-update) or run it straight from the terminal.

Download for Windows

Run the installer. It installs for your user only, no admin needed. The app isn't code-signed yet, so Windows may say "Windows protected your PC": click More info, then Run anyway.

2Log in to your agents

GridHive runs the real CLIs, so each one needs its own login, just like in a normal terminal. If you already use claude or codex, you're done.

Otherwise open Settings → Agents & accounts. It shows which CLIs are installed and logged in, and lets you install and log in to each one. You can add several accounts per agent; when one hits its plan limit, GridHive can move the agent to the next account.

No surprise bills. GridHive hides ANTHROPIC_API_KEY from its terminals, so Claude Code uses your subscription instead of pay-per-token API billing.

3Launch a team

Click Templates in the command bar at the bottom, pick a project folder and start Dev HQ: one orchestrator plus Frontend, Backend and Reviewer agents, each in its own terminal. Or pick Bug squad, Docs crew and others, or build your own with Compose team.

Then tell the orchestrator what you want in the command bar, for example:

Add a checkout page with Stripe payments, with tests.

The orchestrator splits the work and sends a job to each worker. Every job shows as a live line on the board, and each worker's report goes straight back to the orchestrator.

Just one agent?

Click New agent, pick a folder and an agent (Claude Code, Codex, Gemini CLI, Grok Build, OpenCode or any command). Type @ in the command bar to send a message to a specific agent, or @all for everyone.

4Answer what needs you

Agents keep their own permission prompts; GridHive never auto-approves. When one is waiting, it shows Needs you on the board, you get a notification, and the prompt lands in the Actions tab of the sidebar. Answer it there without finding the terminal.

The Progress tab shows each team's todo list, and the Mission Map shows who is working, idle or done. Close the window and agents keep running in the tray (Windows) or menu bar (Mac).

5Take it to your phone

Open Settings → Integrations → Phone, turn it on and scan the QR code with your phone on the same Wi-Fi. Your phone shows every agent, its live terminal and its prompts; you can answer, send a message, launch a team, or hand a session to the phone and back. The agents keep running on your computer.

Phone from anywhere (not just your Wi-Fi) is coming with the free account. Until then, use your home or office network, or a VPN.

Optional: sign in and share

GridHive works fully without an account. Sign in with GitHub or Google (the app asks once; you can skip) to link this computer to your free account. Then the Share button at the top right gives you a link: whoever opens it follows your board live, with everyone's mouse pointers, Figma-style. Viewers can watch, not type.

Next steps