Skip to content
PRESHaiPRESHaiPRESHos Platform

Obsidian sync

The PRESHos Wiki plugin (plugin id preshos-wiki) syncs wiki spaces to Obsidian for two-way editing. It is desktop only and requires Obsidian 1.11.4 or later.

Install

Section titled “Install”

The plugin is not in the Obsidian community-plugin directory. Until it is listed there, install by hand using one of these methods:

  • Manual install from release assets. Download main.js, manifest.json, and styles.css into <vault>/.obsidian/plugins/preshos-wiki/, then enable the plugin.
  • BRAT. Install via the BRAT plugin pointed at Presh-Marketing/preshos-obsidian, then enable.

After install, enable PRESHos Wiki under Settings → Community plugins.

Sign in

Section titled “Sign in”

Go to Settings → PRESHos Wiki → Sign in to PRESHos. The default address is https://preshos.com. If your identity belongs to more than one organization, pick the org to sync. Credentials are kept in Obsidian secure storage, not in the vault.

Sync is per space: only spaces with the Sync to Obsidian toggle on sync to connected vaults — see Wiki spaces. Spaces with the toggle off stay in-product only.

Vault layout

Section titled “Vault layout”

Synced content lands in two top-level folders:

Folder What it holds
PRESHos/My notes/ Your personal space.
PRESHos/Company wiki/ Tenant-wide reference.
PRESHos/ (other folders) Other spaces your session can read.
PRESHos local/ Local-only notes. These never sync back to the tenant.
PRESHos local/Conflicts/ Conflict copies that need your review.
PRESHos local/Removed/ Unsynced local edits left when a page is archived remotely or you lose access.

Keep drafts and scratch work in PRESHos local/; move a note into PRESHos/ only when it is ready to be shared.

Sync behavior

Section titled “Sync behavior”
Action Result
Edit a synced page Syncs to the tenant wiki space.
Create a page under PRESHos/ Creates the page in the space.
Rename a page under PRESHos/ Renames the page in the space.
Delete a page under PRESHos/ Archives the page in PRESHos (restorable there).
Delete more than 5 pages at once Asks first before proceeding.
Conflicting edits Losing copy lands in Conflicts/ for review.
Edit a view-only page Goes to Conflicts/ — view-only pages cannot be written back.
Attachments Do not sync. Page text syncs; attachments stay in-product.

Do not dual-sync the PRESHos/ folder with iCloud, Obsidian Sync, git, or any other sync tool — two syncers on one folder corrupt each other.

Record links survive the round trip: frontmatter about: is plain Markdown, so pages about a record keep their links through sync. See Wiki (in product).

Agent writes still follow Agents in the wiki; Obsidian edits from a human sync as that user (source: sync) and do not go through Approvals.

Commands

Section titled “Commands”

The plugin adds commands including Sync now, Open this page in PRESHos, Sign in, and Sign out. Clicking the status-bar item syncs.

Security notes

Section titled “Security notes”
  • Only spaces with Sync to Obsidian on ever reach a vault — the vault does not widen who may see a space in the tenant.
  • For a lost device, revoke the session in Profile → Security in-product.
  • Credentials live in Obsidian secure storage, never in vault files — do not paste tokens into notes.

Limits

Section titled “Limits”
  • Desktop only. The plugin does not run on Obsidian mobile.
  • Attachments do not sync yet. Page text syncs; attachments stay in-product for now.
  • No graph explorer or other extras in this phase — where the phase scope ends, this page says what is not available rather than promising it.

What next

Section titled “What next”