FAQ

Is OmniSync free and open source?

Yes. OmniSync is MIT-licensed. Download builds from the download page or GitHub Releases, or browse the source in the repository.

Which platforms are supported?

Official installers ship for macOS (Apple Silicon and Intel) and Windows (x64 NSIS). macOS is the most complete experience; Windows is supported with a few differences. Linux AppImages can be built from source. See Platforms.

How is this different from GitHub Desktop?

OmniSync adds a multi-workspace dashboard, collaboration feed (commits × branches), three-pane conflict resolver, environment diagnostics, built-in terminal/dev runner, IDE/browser/Electron launch, and a tooling setup prompt. It is a workspace hub, not only a Git GUI.

Do I need to leave my editor?

No. OmniSync is designed to sit alongside Cursor, VS Code, and other IDEs. Open in IDE is a first-class action.

How do I sign in?

Use GitHub OAuth (bundled device-flow client, or a custom OAuth app) or a personal access token during setup.

Where are credentials stored?

GitHub tokens are encrypted at rest with AES-256-GCM. The encryption master secret lives in the OS keychain / credential store in packaged builds. Tokens are not returned to the browser after auth. See Security.

Why won’t macOS open the app?

Builds are unsigned by default. Right-click the app → Open, then confirm. Details in Install.

Why does Windows SmartScreen block the installer?

Windows builds are unsigned until Authenticode signing is configured. Choose More info → Run anyway when installing from the official GitHub release. See Install.

What if pull fails because branches diverged?

Choose pull merge or pull rebase from the Git Sync UI. See Git Sync.

What if commits are blocked?

Branch protection (on by default) blocks direct commits and pushes to main / master and any custom protected list. Adjust this per workspace in Settings.

Does deleting a workspace delete my code?

No. Only the OmniSync profile is removed. Disk files and GitHub login remain.

Why does OmniSync ask for Full Disk Access?

On macOS, the system may silently block file operations without the right permissions. Documents access is often enough for the default ~/Documents/GitHub clone path.

Is telemetry enabled?

No. The enableTelemetry setting was removed in 0.2b.

Can I develop with Next.js alone?

You can run npm run dev for UI-only work, but the API cookie is not auto-provisioned. Prefer npm run electron · see Build from source.