Edit notes live, auto-sync your vault, comment inline, and review or publish to GitHub without thinking about Git. Use specgit on desktop or phone, solo or with a team.
Edit notes live, auto-sync your vault, comment inline, and review or publish changes to your GitHub repository without thinking about Git.
GitHub is a dependable home for an Obsidian vault: every edit has an author and a history, and engineers already work there. Keeping a vault in step across devices or writing in it with a team is where things break down. Concurrent edits collide, feedback gets scattered across tools, and publishing asks everyone to learn Git.
specgit.com already gives individuals and teams a visual editor for Obsidian vaults in the browser, keeping your Markdown, Canvas boards, and Bases files intact. This plugin brings the best of specgit inside Obsidian on desktop and phone, connecting everyday actions (saving, commenting, and publishing) directly to how GitHub works (commits, pull request review threads, and merges). Teammates can join you from their own Obsidian app, from a browser on specgit.com, or through a connected agent, while your GitHub repository stays the source of truth.
The plugin is free and open source (MIT), specgit includes a Free plan, and Zero Content Retention means we never keep a copy of your documents or comments.

Every note starts Local as an ordinary Markdown file that stays on your device. When you want to collaborate, select Connect Live in the specgit panel. Teammates editing the same note in Obsidian, on specgit.com, or through a connected agent appear as live cursors with their names and avatars. Undo only reverts your own edits, and Disconnect returns the note to Local right away.
Nothing changes silently. If a note changed while you were offline or Local, specgit tells you when you connect and lets you inspect the diff with See changes. When two people edit the same lines, specgit opens a conflict resolution screen with one card per overlapping edit, letting you pick Keep mine, Keep theirs, Keep both, or Edit. Closing that screen leaves your note Local with nothing lost.

Select any passage and choose Comment with specgit to open a review thread tied to those words. Read, reply, resolve, and reopen threads in the Comments tab, or apply a teammate's proposed wording with Apply suggestion. Comment highlights are visual markers only and never alter your Markdown.

The Status tab tracks every draft, changed note, Canvas board, and Bases file in your linked folder, along with reviews waiting on you. Each row shows its state (Draft, In review, Ready to publish, and more). Select one or several files to Submit for review, assign reviewers, Approve or Ask for changes inside Obsidian, and Publish once approved.
On Pro and Pro Plus plans, Group together combines multiple related files into one review (a single pull request in GitHub) so they are reviewed and published as a set. Publishing always takes your explicit click.
Canvas live editing, Writing mode, Riff, and Ask Agent live on specgit.com, one click away via Open in specgit.
Stay connected is off by default. Turn it on at the top of the panel to keep your linked folder in step without opening each note:
If your vault isn't on GitHub yet, choose Put this vault on GitHub from the panel, the repository picker, or the command palette. specgit creates a private GitHub repository (or public, if you switch it) and uploads your vault.
.gitignore file.specgit, install it, and turn it on.
The panel uses Obsidian's native colors and typography across light mode, dark mode, and community themes. On mobile, it opens in the right sidebar drawer.
| Dark theme | Mobile |
|---|---|
![]() |
![]() |
| Plan | Price | Includes |
|---|---|---|
| Free | $0 | Unlimited collaborators, 1 repository, 5 publishes a month |
| Pro | $8/seat/month ($6.40/seat/month billed yearly) | Unlimited repositories, unlimited publishes, Group together |
| Pro Plus | $16/seat/month ($12.80/seat/month billed yearly) | Everything in Pro, plus $10/month of agent usage per seat on specgit.com |
Only editors use paid seats; viewing and commenting are free. Full details are at specgit.com/pricing.
Zero Content Retention: we never keep a copy of your documents or comments. While people edit a note together, specgit holds temporary live-editing state to sync and save changes to your GitHub repository. See retention details in the Privacy Policy.
The plugin contains no client-side analytics or tracking.
| Service | Purpose |
|---|---|
specgit.com |
Sign-in (GitHub login, display name, avatar URL), pre-connect room presence count, short-lived room tokens, GitHub file comparisons, reading/posting/resolving comments, repository and file metadata for the Status tab (names and Git IDs, never file text), submitting reviews and publishing on your click, creating/uploading a vault on Put this vault on GitHub, and sending Report a problem submissions when you press Send. |
wss://specgit.com/realtime |
Real-time sync of live note text and cursor positions with other people in the note. |
avatars.githubusercontent.com and private-avatars.githubusercontent.com |
Loading collaborator profile pictures. No auth token or note metadata is sent; initials are shown if unavailable. |
Your notes and comments reach GitHub only through specgit; profile pictures are the only direct requests to GitHub. An Advanced setting lets developers point the plugin at a custom specgit server.
data.json): chosen repository, linked folder, cursor color, GitHub profile metadata, and server URL. The Stay connected toggle is stored per device only.The plugin creates no files of its own in your vault beyond notes you explicitly pull in via Copy them in or Stay connected.
On desktop only, and only while Stay connected is enabled, the plugin reads .git/logs/HEAD and .git/logs/refs/stash (inside your vault's .git folder, a parent .git folder, or the target of a .git file) about once per second. This distinguishes Git operations like pull or checkout from your own typing so Git changes aren't submitted as new edits. The plugin reads nothing else outside your vault, writes nothing there, and sends none of it off your device. On mobile, it accesses nothing outside your vault.
This plugin is open source under the MIT License. The specgit web app and realtime service are closed source.
Use Report a problem in Settings → specgit, or visit specgit.com/support.
npm ci
npm run build
Made by FnFirst.