Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Emanuele-web04/synara/llms.txt

Use this file to discover all available pages before exploring further.

Synara is a local-first desktop workspace that lets you run AI coding agents — Claude Code, Codex, Gemini, Grok, OpenCode, Cursor, Kilo Code, and Pi — side by side in a single window. Instead of juggling browser tabs, terminal emulators, and editor extensions for each provider, you get one focused environment where chat, terminal output, browser previews, diffs, and Git controls all live together.

The problem Synara solves

Modern AI-assisted coding means managing subscriptions and CLI tools across multiple providers, switching contexts constantly, and trying to keep track of which agent is working on which branch. That friction adds up fast. Synara removes the juggling act by treating every provider you already pay for as a first-class participant in one workspace. You can start a Claude Code session on a feature branch, open a parallel Codex thread on a separate worktree, and hand off context to Gemini without leaving the app or copying prompts by hand.

Key features

Parallel Agent Threads

Run multiple agent sessions at the same time across different projects, threads, and isolated Git worktrees so branches never step on each other.

Multi-Provider Support

Use Claude Code, Codex, Gemini, Grok, OpenCode, Cursor, Kilo Code, and Pi — whichever accounts you already have — without switching apps.

Provider Handoff

Pass an active thread to a different provider mid-session so a second model can continue with the same context and history.

Integrated Terminal

A full PTY-backed terminal lives beside each chat thread. Agent output, shell commands, and live file changes are visible in the same window.

Git Workflow

Review diffs, create branches, commit, push, and open pull requests without leaving Synara. Worktree support keeps parallel work isolated at the file-system level.

Remote Access

The local server can bind to a custom host or Tailnet IP, so you can reach your workspace from another device on the same network.

How Synara is built

Synara runs as three cooperating layers on your machine:
  • Local server (apps/server) — a Node.js/Bun process that manages projects, threads, provider sessions, Git operations, terminals, and the SQLite database that stores all your workspace state. It exposes an HTTP and WebSocket API on localhost:3773 by default.
  • Electron desktop (apps/desktop) — a thin Electron shell that starts and supervises the local server, handles OS-level integration (window chrome, system tray, auto-update), and hosts the web UI in a native app window.
  • Web UI (apps/web) — a React application served from the local server. Because it is a standard web app, it also works in a browser when you run Synara in web mode or expose it to another device on your network.
In desktop mode the server binds to 127.0.0.1 and is only reachable from localhost. In web mode it finds an available port starting at 3773 and can optionally bind to a wider interface.

Privacy model

Synara has no cloud backend. Every project, thread, chat message, diff, and piece of workspace history is stored in a SQLite database on your own machine under ~/.synara (or a directory you configure with SYNARA_HOME). When you send a message, Synara forwards only the prompts, file snippets, diffs, terminal output, or tool results that are part of that session to the provider you selected — Claude, OpenAI, Google, or whichever you chose. That traffic goes directly from your machine to the provider’s API. Synara itself never receives or relays that content.
Synara stores all runtime data — database, logs, and settings — under ~/.synara by default. You can override the base directory by setting the SYNARA_HOME environment variable before launching the app. Everything stays entirely on your machine.

Next steps

Install Synara

Download the desktop app or build from source with Bun.

Quickstart

Open your first project and run your first agent session in under five minutes.

Build docs developers (and LLMs) love