# Synara documentation

Canonical URL: https://www.trysynara.com/docs

Synara is a free, open-source, local-first desktop workspace and control plane for coding agents. It brings provider sessions, tasks, terminals, browser work, diffs, Git worktrees, handoffs, automations, and pull-request delivery into one application.

<Cards>
  <Card title="Quickstart" description="Go from installation to your first reviewed diff in about five minutes." href="/docs/getting-started/quickstart" />

  <Card title="Provider guides" description="Install, authenticate, verify, and troubleshoot every supported coding-agent runtime." href="/docs/providers" />

  <Card title="Workflow guides" description="Run parallel agents, worktrees, handoffs, browser verification, automations, and orchestration safely." href="/docs/workflows" />

  <Card title="Remote Connections" description="Pair a second computer and control Synara on one computer from another. New in 1.5 with Synara Alto." href="/docs/features/remote-connections" />

  <Card title="Troubleshooting" description="Recover from desktop, provider, task, Git, browser, automation, and integration failures." href="/docs/troubleshooting" />
</Cards>

## New in 1.5 [#new-in-15]

[Remote Connections](/docs/features/remote-connections) let you control Synara on one computer from another: open its workspaces, steer chats, and handle approvals while it is online. They work on macOS, Windows x64, and Linux x64, and are included with [Synara Alto](/pricing). [Synara for iPhone](/remote) brings the same control to iPhone and iPad, in public beta on TestFlight. Computers signed in to your account also save daily [Inbox recaps](/docs/features/tasks-and-inbox#read-saved-recaps-when-a-computer-is-offline) you can read while the source is offline.

## New in 0.9.2 [#new-in-092]

[Synara Beta](/docs/features/synara-beta) installs alongside Stable with separate data and updates. On macOS, open Settings → General to install Beta or copy Stable data into it.

## New in 0.9.0 [#new-in-090]

[Computer Use beta](/docs/features/computer-use) lets Synara work with Mac apps and browsers. It is macOS-only for now; Linux is coming soon. [Project import](/docs/features/project-import) brings local Codex and Claude Code conversations into your workspace. Provider guides cover [Claude cache review and Artifacts](/docs/providers/claude-code) and [Codex question cards and banked resets](/docs/providers/codex).

## Editing and browser work in 0.8.4 [#editing-and-browser-work-in-084]

Read [Workspace editor & diffs](/docs/features/workspace-editor) for autosave, conflict recovery, revision comparison, and partial diffs. [Composer & attachments](/docs/features/composer) covers selection-to-new-chat and AppSnap window capture; [Browser verification](/docs/workflows/browser-verification) covers shared browser verification. [Browser logins & sessions](/docs/features/browser-sessions) explains account storage, cookie import, and optional Safari setup.

## What is Synara? [#what-is-synara]

Synara is the workspace around coding-agent runtimes such as Claude Code, Codex, OpenCode, Cursor, Antigravity, Grok Build, Devin CLI, Pi, Oh My Pi, and Factory Droid. The provider still owns its account, models, tools, permissions, and service. Synara owns the durable task, working environment, transcript, review surfaces, and delivery workflow around that provider session.

## What does Synara control? [#what-does-synara-control]

* **Projects and tasks:** keep several repositories and durable conversations available without mixing their context.
* **Provider runtimes:** select supported coding agents, models, and provider-specific options from one interface.
* **Development surfaces:** use terminals, browser tabs, files, diffs, and Git tools beside the conversation.
* **Git environments:** work in the local checkout or isolate concurrent tasks in linked worktrees.
* **Review and delivery:** inspect changes, verify behavior, commit, push, and create pull requests.
* **Orchestration:** use provider handoffs, automations, Studio, Agent Gateway, and restricted External MCP access where appropriate.

## Does Synara include model access? [#does-synara-include-model-access]

No. Synara uses the provider runtimes, accounts, subscriptions, and API credentials already configured on your machine. Model availability and usage limits remain provider-owned.

Start with [Installation](/docs/getting-started/installation) and the [Provider guides](/docs/providers).

## Does Synara upload code to its own cloud? [#does-synara-upload-code-to-its-own-cloud]

Synara stores its workspace data locally and does not require a Synara cloud account. The provider selected for a task still receives the prompts, file snippets, diffs, terminal output, or tool results needed for that provider session. Synara is the control surface; it is not a proxy for normal provider traffic.

See [Privacy](/privacy) for the public data boundary.

## How should I run my first task? [#how-should-i-run-my-first-task]

Use one clean Git repository, one provider you have already verified, and one bounded objective. Follow the transcript, inspect the complete diff, run the relevant checks independently, and commit only the changes you understand.

Use the [Quickstart](/docs/getting-started/quickstart) for the shortest path or [Your first task](/docs/getting-started/first-task) for the complete walkthrough.

## How do I run several agents safely? [#how-do-i-run-several-agents-safely]

Give each body of work one owner and use separate worktrees for concurrent writers. Keep objectives independently reviewable, preserve Git state before integration, and assign one integration owner.

Continue with [Parallel agents](/docs/workflows/parallel-agents) and [Worktrees](/docs/workflows/worktrees).

## Where do I go when something fails? [#where-do-i-go-when-something-fails]

Start with the symptom-specific [Troubleshooting hub](/docs/troubleshooting). Preserve work before restarting or cleaning up, identify the failing layer, change one variable at a time, and collect the smallest useful diagnostic bundle.

<Callout type="info" title="Stable release versus current main">
  Most pages describe stable behavior. Features available only on the active application `main`
  branch are identified as preview behavior where that distinction matters.
</Callout>

## Synara 1.5.0 Stable [#synara-150-stable]

See [Remote connections and Synara Alto](/docs/features/remote-connections) to pair devices and manage your subscription. [Saved Inbox recaps](/docs/features/tasks-and-inbox#read-saved-recaps-when-a-computer-is-offline) are available when the source computer is offline.

## Explore 1.0.0 Stable [#explore-100-stable]

Start with [Inbox and Kanban](/docs/features/tasks-and-inbox), [provider accounts](/docs/features/provider-accounts), and [terminal panels](/docs/features/terminal-panels). The [Beta guide](/docs/features/synara-beta) explains which features require the separate Beta app and how its data stays isolated.

## Latest Beta workflows [#latest-beta-workflows]

Synara 1.0.1-beta.2 adds [multi-folder projects](/docs/features/multiple-folders), message-content search in [Organize & navigate](/docs/features/organize), and independent [right-dock terminals](/docs/features/terminal-panels).

## 1.0.2 Stable workflows [#102-stable-workflows]

Read the [subagent guide](/docs/features/subagents), [history and reload guide](/docs/features/conversation-history), and [queue pause controls](/docs/features/composer#pause-and-resume-queued-messages). Tasks is available in Stable 1.0.1; Hubs are available in Stable 1.0.2 and Beta.

## Stable 1.0.5 and the next Beta [#stable-105-and-the-next-beta]

Read [Inline visuals](/docs/features/inline-visuals) for interactive charts and tools in Stable chats, [Composer](/docs/features/composer#compact-composer-and-work-capsules) for the compact input, and [Activity Priority](/docs/features/organize#work-through-activity-priority) for attention controls. The [iOS simulator guide](/docs/features/ios-simulator) covers screen evidence and Xcode 27 input. [Connectors](/docs/features/connectors) require Stable 1.0.9 or Beta 1.0.6-beta.1 and a supported provider.

## Stable 1.0.9 [#stable-109]

Use [native editor intelligence and JavaScript debugging](/docs/features/workspace-editor#native-editor-and-javascript-debugger) and [Connectors](/docs/features/connectors) in Stable. Read [runtime recovery](/docs/troubleshooting/tasks-and-runtime#compressed-migration-backups-in-109) for compressed migration backups, [OpenCode](/docs/providers/opencode#isolated-sign-in-and-cold-model-discovery-in-109) for isolated sign-in and [Thread goals](/docs/features/thread-goals) for visible goal startup.
