Getting started

Synergoi is a Mac app that drives the coding agents you already pay for — Claude Code, Codex, Grok, Cursor Agent, Antigravity and local models — from one window, with quotas, approvals and shipping handled once. Setup takes about two minutes and asks for nothing you don't already have.

Requirements

• macOS on Apple Silicon (M1 or later). Intel Macs are not supported. A Windows build is in progress and not for sale yet.
• At least one provider login. A Claude Pro/Max, ChatGPT Plus/Pro, SuperGrok, Cursor or Google account — or a local model runtime such as Ollama. See Providers.
• git on your PATH (ships with Xcode Command Line Tools). Synergoi's worktree model is built on it.

1. Install

Open the DMG, drag Synergoi to Applications, and launch it. The app is signed and notarized by Apple, so Gatekeeper opens it without warnings. On first launch it installs its own copies of the Claude and Codex adapters into its data folder — nothing is written into your projects.

Updates are automatic: the app checks updates.tracewyn.com on launch and installs the next version in the background. You can also check from Settings › General › Check for updates.

2. First run: Activate → Connect → Start

The first-run flow has three screens and appears only once.

1. Activate

   Paste the license key from your Lemon Squeezy receipt email, or start a 7-day free trial from the same screen. Details in License & billing.

2. Connect

   Synergoi scans for the official CLIs and adopts logins you already have. If claude, codex, grok, cursor-agent or agy is installed and signed in, the provider shows as connected without you doing anything. Missing one? The screen shows the install command and the vendor's own login flow — Synergoi never sees your password.

3. Start

   Pick a folder. A folder is a project; Synergoi registers the git repository it finds there. Your first thread opens on a fresh branch in its own worktree.

3. Your first thread

Type in the composer and press Enter. The provider pill on the left of the composer chooses the model for this turn; the access pill next to it (Ask by default) chooses what the agent may do without asking. Everything the agent reads, edits or runs appears in the transcript as it happens.

• While a turn is running, Enter queues your next message; ⌘Enter interrupts and sends now. ⌘. stops the turn.
• Approvals arrive in the transcript, in the inbox (⇧⌘A) and as a macOS notification, so you can leave the window.
• When the turn ends, a Files changed card lists what was touched with the line counts and anUndo this turn button. Open the Changes dock to review, stage and ship — see Changes & Ship.

Where next

• Quotas, caps & failover — read your meters and set a fallback before a wall hits.
• Models, mentions & side-asks — mix models inside one thread.
• Access presets & approvals — decide once what agents may do unattended.
• Keyboard shortcuts — the whole app in eight chords.