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.
System requirements
| Requirement | |
|---|---|
| Windows | Windows 10 or 11, 64-bit |
| Web runtime | Microsoft Edge WebView2 (built into Windows 11; the installer checks it and offers to install it) |
| Agents | At least one of: Claude Code (Claude subscription), Codex (ChatGPT subscription), Antigravity agy (Google account), Cursor |
| Git | Recommended. Worktrees, review and merge need a git project; without git, agents still work in the folder itself |
| Remote servers | Optional: a Linux or macOS server reachable over SSH (Windows OpenSSH client) |
| Network | Internet for sign-in and for your AI providers. The app keeps working offline for about an hour between license checks |
Install
- 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
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
WebView2
The installer checks the WebView2 runtime and installs it if it’s missing or too old.
- 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:
Get-FileHash .\SyntobiMind-Setup-*.exe -Algorithm SHA256To 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
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
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
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.
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.
| Provider | Runs on | Notes |
|---|---|---|
| Claude Code | Your Claude subscription | Steering mid-turn, approval cards for anything Claude Code would ask about |
| Codex | Your ChatGPT subscription | Runs in Codex’s sandbox; asks for review when something needs to reach outside it |
| Antigravity | Your Google account (agy) | Not available in every region — the card says so and offers Check again |
| Cursor | Your Cursor account | Approval 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.
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
| Mode | Shortcut | Best for |
|---|---|---|
| Agent | Ctrl+1 | A readable conversation with one agent: grouped tool calls, markdown, turn tabs |
| Code | Ctrl+2 | Live terminal-style panes for many agents at once — up to 32, with follow-ups, maximize and stop per pane |
| Thread | Ctrl+3 | Every conversation kept; reopen and continue any of them |
| Chat | Ctrl+4 | Plain 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.
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 mode | What happens |
|---|---|
| Auto | Safe steps run on their own; anything risky asks |
| Ask me | Every write and command waits for your Allow or Deny |
| Accept edits | File edits go through; shell commands ask |
| Read-only | No writes at all — agents look and report |
| Bypass | No 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.
| Keys | Action |
|---|---|
| Ctrl+K | Command palette: modes, workspaces, agents, chats, settings |
| Ctrl+L | Command deck |
| Ctrl+N | New session (a lineup of agents) |
| Ctrl+O | Open a folder as a workspace |
| Ctrl+1 … Ctrl+4 | Agent, Code, Thread, Chat |
| Ctrl+B / Ctrl+J | Toggle side panels |
| Ctrl+. | Stop the selected agent |
| Ctrl+Shift+X | Stop all agents |
| Enter / Shift+Enter | Send / 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.
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.
| Problem | What to do |
|---|---|
| An agent tool isn’t found | Install 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 start | Repair or reinstall the WebView2 runtime, then reopen SyntobiMind |
| “Signed out” on this device | Your 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 PC | Turn 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.