HomeDocs

Documentation

The SyntobiMind guide

Everything you need to run a crew of AI coding agents on Windows: install, connect your agents, give Simorgh a goal, review and merge the results — plus every setting, shortcut and fix.

What SyntobiMind is

SyntobiMind is a native Windows app that runs AI coding agents — Claude Code, Codex, Antigravity and Cursor — side by side on your project folders. You describe a goal; Simorgh, the conductor, reads the project, splits the goal into independent tasks and launches one agent per task. Each agent works in its own git worktree, a review desk checks every branch, and the results merge back into your project with a backup and one-click Undo.

Agents run on your computer through the official command-line tools you already use, signed in to your own subscriptions. Your code, prompts and answers go only to the AI provider you chose — never to SyntobiMind.

New here? Follow Install, Sign in & plans and Connect your agents, then try your first goal in The command deck. It takes about five minutes.

System requirements

Requirement
WindowsWindows 10 or 11, 64-bit
Web runtimeMicrosoft Edge WebView2 (built into Windows 11; the installer checks it and offers to install it)
AgentsAt least one of: Claude Code (Claude subscription), Codex (ChatGPT subscription), Antigravity agy (Google account), Cursor
GitRecommended. Worktrees, review and merge need a git project; without git, agents still work in the folder itself
Remote serversOptional: a Linux or macOS server reachable over SSH (Windows OpenSSH client)
NetworkInternet for sign-in and for your AI providers. The app keeps working offline for about an hour between license checks

Install

  1. 1

    Download the installer

    Use Download for Windows on this site. The download page shows the version, size and the installer’s SHA-256 so you can verify the file.

  2. 2

    Run it

    Double-click SyntobiMind-Setup-<version>.exe. If Windows SmartScreen shows a warning for a new release, choose More info › Run anyway — but only for a file you downloaded from syntobimind.ir.

  3. 3

    WebView2

    The installer checks the WebView2 runtime and installs it if it’s missing or too old.

  4. 4

    Open SyntobiMind

    It starts from the Start menu, and can start with Windows if you turn that on in Settings.

To check the file yourself, run this in PowerShell in your Downloads folder and compare the result with the SHA-256 shown on the download section:

PowerShell
Get-FileHash .\SyntobiMind-Setup-*.exe -Algorithm SHA256

To uninstall, use Settings › Apps in Windows. Your workspaces and transcripts in %APPDATA%\SyntobiMind are kept unless you delete that folder.

Sign in & plans

The first time you open SyntobiMind it asks you to sign in or create an account with your email and a password. Your account holds your plan and the devices you use.

  1. 1

    Pick a plan

    Right after signing up you see See plans. Later, open Settings › Account and choose Plans or Upgrade. Each plan lists what it includes — how many agents run at once, Simorgh, Chat, SSH servers and which providers.

  2. 2

    Review your order

    Choose monthly or yearly. Moving up mid-term is prorated: you pay the daily difference for the days left, and your end date stays the same.

  3. 3

    Pay card-to-card

    The app shows the card to pay to and the exact amount. Transfer that amount from your bank app or ATM. The payment is matched automatically — usually within a minute — and your plan switches on at once, without a restart.

Transfer the exact amount shown, to the rial: that’s how your payment is recognised automatically. If something goes wrong, open Settings › Support and include your order code (SM-…).

Plans don’t renew or charge by themselves; renew from Settings › Account. Each plan allows a number of devices; signing in on one more device usually signs out the one used longest ago. You can see and remove devices in Settings › Account.

Connect your agents

Open Settings › Providers. SyntobiMind finds each agent tool on your PATH, in npm, ~/.local/bin, the Codex app or the VS Code/Cursor extensions, and shows whether it’s signed in.

ProviderRuns onNotes
Claude CodeYour Claude subscriptionSteering mid-turn, approval cards for anything Claude Code would ask about
CodexYour ChatGPT subscriptionRuns in Codex’s sandbox; asks for review when something needs to reach outside it
AntigravityYour Google account (agy)Not available in every region — the card says so and offers Check again
CursorYour Cursor accountApproval cards through Cursor’s agent protocol

Use Connect on a card to sign in with that provider’s own login. If a tool lives somewhere unusual, set its path on the card. API keys for other agents are separate — see Chat & API keys.

Usage comes from your subscriptions: SyntobiMind strips API-key environment variables so agents never bill an API account by accident. The usage meter in the title bar shows each account’s 5-hour and weekly windows.

Workspaces

A workspace is a project folder. Add one with + in the sidebar, Ctrl+O, or by dropping a folder on the window. Opening a workspace shows the New session sheet: start from the command deck, or launch a lineup of agents side by side (Ctrl+N) — presets, providers, how many, and the model and effort of every seat.

Workspaces can also live on a server — see SSH servers.

Modes

ModeShortcutBest for
AgentCtrl+1A readable conversation with one agent: grouped tool calls, markdown, turn tabs
CodeCtrl+2Live terminal-style panes for many agents at once — up to 32, with follow-ups, maximize and stop per pane
ThreadCtrl+3Every conversation kept; reopen and continue any of them
ChatCtrl+4Plain conversations with API models, per-message cost and Compare

Every mode shows Persian and right-to-left text correctly: SyntobiMind renders answers itself instead of relying on a terminal.

The command deck & Simorgh

The command deck (Ctrl+L) is where a goal starts. Write it in English or Persian, then choose:

  • Strategy — Orchestrate (Simorgh plans and runs a team), Broadcast (the same prompt to several agents) or Solo (one agent).
  • How many — 1 to 32 agents. A count written in the goal (“run 8 agents”, ⁧«با هشت تا ایجنت»⁩) wins, and the deck shows it live.
  • Provider and model, permission mode and effort. Mix builds a crew across several providers.

With Orchestrate, Simorgh reads the project read-only, returns a plan of independent tasks, gives each to a worker (telling every worker what the others own), and writes a final report. The Plan tab in the dock shows each run and its rounds live.

When a run finishes, give Simorgh the next goal — from the Plan tab or the conductor’s composer. The same team takes it with its context; ask for more agents in the goal to grow the team.

Worktrees, review & merge

In a git project every worker gets its own git worktree (Settings › Agents › “Separate worktree per agent”, on by default). Agents can’t overwrite each other, a build never sees another agent’s half-finished edit, and nothing reaches your project until it’s merged.

  • The review desk checks each finished branch — with co-reviewers on big teams — and marks it accepted or sends it back with notes.
  • Accepted work merges into your project. A backup is taken first, so Undo puts everything back in one click.
  • In Auto, accepted branches merge and commit by themselves; in the other modes you merge from the merge card.
Your branches, index, stash and uncommitted files are never touched by a round: the starting point is a private snapshot, and worktrees live outside the project folder.

Steering, approvals & team access

Steering: a message sent while an agent works shows at once and reaches it at its next step, not after the whole turn. A running command is never cut; the newer message wins where it conflicts.

Permission modeWhat happens
AutoSafe steps run on their own; anything risky asks
Ask meEvery write and command waits for your Allow or Deny
Accept editsFile edits go through; shell commands ask
Read-onlyNo writes at all — agents look and report
BypassNo questions. Use only in a throwaway folder

Approval cards show exactly what an agent wants to run or touch. Always allow for team keeps that rule (a command prefix or a folder) for every agent of the workspace.

Team access (per workspace) lists folders outside the project, standing rules and network access shared by every agent — including agents added later. A folder named in a goal (for example a notes vault) joins automatically.

Checkpoints & rewind

When agents edit the project folder directly (Solo, Broadcast, crew), every turn is a checkpoint: a private snapshot of the files before the turn, plus the list of files the turn changed.

Click the checkpoint marker in a transcript to open the rewind sheet. It lists the files that will change with mini diffs, and flags files someone else changed since — those are left alone unless you pick them. Rewinding takes a safety checkpoint first, so Undo brings you back.

Tasks & Memory

Tasks is each project’s to-do list with a seven-day runway: drag a task onto a day, add quickly with #tag, ! and a date, keep or dismiss tasks agents suggest, and hand any task to an agent or the command deck. Plan this day lets an agent schedule the day for you.

Memory is what every agent of the project is told at the start of each turn: notes by kind with switches, linked folders and files, and a per-turn token meter. Agents can propose notes for you to approve.

Built-in browser

The dock’s Browser has real tabs and a full-screen mode. Links clicked in terminals and chats open there (Ctrl/Shift+click opens your system browser). Agents open the sites, local servers and files they build there too — so a preview appears right beside the code.

SSH servers

Add a server in Settings › Servers (or Connect to a server). SyntobiMind uses the Windows OpenSSH client with a password, a key or your SSH agent, tests the connection and helps install the agent tools on the server.

In an SSH workspace, agents, the terminal and the Changes panel run on the server. Sessions survive network drops and closing the app, and ports are forwarded so previews open in the built-in browser.

Chat & API keys

Chat mode talks to Claude, GPT, Gemini or any model behind your own API keys — OpenRouter, OpenAI, Anthropic, Google AI Studio, Groq, DeepSeek, xAI, Mistral and Together. It can’t edit files; optionally it can read the active workspace.

Compare asks two or three models at once and shows the answers side by side. Each message shows its cost (exact on OpenRouter, estimated elsewhere) and every chat keeps a running total. Keys are encrypted with Windows DPAPI in %APPDATA%\SyntobiMind\keys.json and are never given to agents.

Settings & shortcuts

Settings has tabs for Account, Providers, API keys, Appearance (theme, interface size, effects, Lite mode for older PCs, close to tray), Agents, Servers, MCP servers, Skills, Shortcuts, Data, Support and About.

KeysAction
Ctrl+KCommand palette: modes, workspaces, agents, chats, settings
Ctrl+LCommand deck
Ctrl+NNew session (a lineup of agents)
Ctrl+OOpen a folder as a workspace
Ctrl+1 … Ctrl+4Agent, Code, Thread, Chat
Ctrl+B / Ctrl+JToggle side panels
Ctrl+.Stop the selected agent
Ctrl+Shift+XStop all agents
Enter / Shift+EnterSend / new line

Closing the window asks once whether SyntobiMind should keep running in the tray (agents keep working) or quit; tick Remember my choice to stop asking.

Updates

New versions appear in the bell with what changed. Update and restart downloads the installer, checks its size and SHA-256 against a release signed by SyntobiMind, installs it silently and reopens the app — your workspaces and settings stay. Updating waits until no agent is working.

Required updates: sometimes a version must be installed to keep using SyntobiMind (for example a security fix). The window then shows the update screen. You can still minimise, close or quit and come back later — but the app opens to the same screen until it’s updated.

Support & troubleshooting

Open Settings › Support to report a bug, a problem or share an idea. The form can attach your app and system details; answers arrive live in the app as a conversation.

ProblemWhat to do
An agent tool isn’t foundInstall it, or set its path on its card in Settings › Providers
Antigravity says “not available in your location”Google limits some regions; use Check again later, or another provider
The window is blank on startRepair or reinstall the WebView2 runtime, then reopen SyntobiMind
“Signed out” on this deviceYour plan allows fewer devices, or you signed in elsewhere — sign in again or remove a device
“SyntobiMind is locked on this computer”Contact support with the device reference shown on that screen
Slow or choppy on an older PCTurn on Lite in Settings › Appearance

Your data

Workspaces, transcripts and settings live on your computer in %APPDATA%\SyntobiMind. Checkpoints live in your project’s git data. The license server only knows your account, plan, devices and payments — see the Privacy Policy.

↑ Back to top