skills.rest
Wh1tZz
Wh1tZzCOMMUNITY
Explore all skills by this author →
GitHub

obsidian-through

Configure and verify private Obsidian synchronization across Windows, macOS, GitHub, and mobile devices.

33|1|Updated Jun 24, 2026
Search Tags:#github#obsidian#git sync#windows automation#note synchronization#private repository#mobile setup
One-click install
npx skills add https://github.com/Wh1tZz/Obsidian-through --skill obsidian-through-wh1tzz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian-through
Source: https://github.com/Wh1tZz/Obsidian-through
Command: npx skills add https://github.com/Wh1tZz/Obsidian-through --skill obsidian-through-wh1tzz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Setting up Obsidian synchronization across a desktop computer, a private GitHub repository, and mobile devices normally requires learning Git commands, GitHub authentication, and platform-specific configuration scattered across many tutorials. This Skill automates the entire setup, verification, and repair workflow so notes stay in sync without manual Git expertise. ## Core Features & Use Cases - Automated desktop setup: Detects Windows or macOS, installs Git and GitHub CLI if missing, handles GitHub web login, locates the Obsidian vault, and creates or connects a private GitHub repository with safe merging instead of force-pushes. - Platform-specific auto-sync: Installs a hidden Windows event watcher with watchdog recovery that commits and pushes after editing stops, and configures Obsidian Git plugin timers on macOS. - Guided mobile onboarding: Generates personalized GitHub account, repository, clone URL, and commit email values, then walks through fine-grained token creation, cloning, and Obsidian Git plugin settings for phones and tablets. - Diagnosis and recovery: Repairs authentication, network, duplicate-note, and merge-conflict issues, and recovers accidentally deleted notes from Git history. - Use Case: A user writes a note in Obsidian on their phone during a commute; it syncs to a private GitHub repository and appears automatically in their Windows or macOS Obsidian vault, with full version history preserved. ## Quick Start Ask the assistant to use obsidian-through to configure synchronization between your computer's Obsidian vault, a private GitHub repository, and your mobile Obsidian app.

Frequently Asked Questions about obsidian-through

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Obsidian notes between my computer and phone using GitHub?▼

Run npx obsidian-through on your desktop; it detects Windows or macOS, connects your vault to a private GitHub repository, and configures automatic sync. It then generates personalized values and step-by-step guidance for setting up the Obsidian Git plugin on your phone or tablet.

How do I set up automatic Git sync for Obsidian on Windows?▼

The skill installs a hidden Windows event watcher that monitors note creation, edits, renames, and deletions. It commits and pushes about 15 seconds after editing stops, silently pulls every 30 seconds when the worktree is clean, and includes a watchdog task that restarts the watcher after failures.

Does Obsidian Git sync work on macOS without Windows scheduled tasks?▼

Yes. On macOS the workflow uses native Git, GitHub CLI, and the Obsidian Git plugin instead of Windows scheduled tasks. It configures a 0.5-minute auto commit-and-sync interval, sync after stopping edits, and pull on startup.

What permissions does the GitHub token need for mobile Obsidian sync?▼

Create a fine-grained personal access token restricted to only your notes repository, with Contents set to Read and write and Commit statuses set to Read and write when available. Metadata stays Read-only, and the token is never shared in chat or written into notes.

Can I recover accidentally deleted Obsidian notes synced through Git?▼

Yes. Because every change is committed to the GitHub repository, deleted or overwritten notes can be restored from Git commit history. Stop syncing on all devices first, then follow the recovery procedure in the troubleshooting reference.

Why does mobile Obsidian sync stop working in the background?▼

Mobile operating systems suspend background apps after screen lock, app switching, or battery restrictions, so automatic sync is only reliable while Obsidian stays in the foreground. Run Git: Pull before editing and Git: Commit-and-sync before leaving the app as a reliable fallback.

Related Skills

Explore More Software Engineering Skills→
borealBytesborealBytes
7

obsidian

Automate Obsidian vault management with obsidian-cli for notes and structures.

Community
Intermediate
basicmachines-cobasicmachines-co
25

memory-reflect

Review recent notes and conversations to consolidate insights into MEMORY.md.

Official
Intermediate
DataKnifeAIDataKnifeAI

surveillance-monitoring

Query UniFi Protect surveillance data to monitor cameras, events, and system health.

Official
Intermediate
kevinnftkevinnft
13

obsidian-mobile-sync

Automate mobile Obsidian vault syncing via GitHub workflows or Obsidian Sync.

Community
Intermediate