Obsidian Sync Plugin

The official Linkwise plugin syncs your saved links, AI summaries, highlights, and collections from Linkwise into your Obsidian vault as clean Markdown notes.

Sync is one-way (Linkwise → Obsidian), incremental (only what changed), and local-first - Linkwise keeps your summaries and highlights up to date, while anything you write in a note is never overwritten.

1. Open the Obsidian community plugin marketplace and search for "Linkwise".
2. Install and enable the plugin.
3. Connect - show the QR code in the Obsidian plugin settings and scan it with the Linkwise app (or paste the token manually).
4. Tap Sync now - done. Optionally turn on auto-sync.

Linkwise syncs the links you've saved, organized by their collection. To control what lands in Obsidian, organize links into collections in the Linkwise app - each collection becomes a folder in your vault. (Fine-grained tag/status filters in the plugin are on the roadmap.)

Set the auto-sync interval in the plugin settings:

• Manual only (default) - syncs only when you run the command. Recommended if you like to control exactly when notes are written.
• Every 15 / 30 / 60 / 180 minutes - the plugin pulls new changes on that schedule in the background.

Trigger a manual sync any time via:

• The circular-arrows ribbon icon, or
• Command palette (Cmd/Ctrl+P) → "Linkwise: Sync now", or
• The Sync now button in settings.

Each item is tracked by a hidden linkwise_id, so re-syncing updates notes in place and never creates duplicates - even if you renamed or moved the note.

Linkwise/
  Research/
    🗺️ Research.md              ← Map of Content: the hub note linking every link in the collection
    Agent Harness Engineering.md
    Attention Is All You Need.md
  Unsorted/                     ← links you haven't filed into a collection yet
    🗺️ Unsorted.md
    …

Each collection folder has a Map of Content - a hub note named 🗺️ that wikilinks every link in the collection. The 🗺️ marker in its name makes it pop in the graph and file explorer, and its title comes straight from the filename. A summary callout shows a live link count, and the #linkwise/moc tag drives the graph coloring:

---
linkwise_moc: true
collection: "Research"
tags: [linkwise/moc]
---

> [!info] Map of Content
> Index of the **Research** collection : 12 links.

- [[Agent Harness Engineering]]
- [[Attention Is All You Need]]

In the graph view, this hub becomes the center of a small cluster. Run Linkwise: Set up graph colors to color the hubs distinctly (see Make the graph pop below).

Each note:

---
linkwise_id: "cf2cf531-…"      ← don't edit; this is how sync tracks the note
title: "Agent Harness Engineering"
url: "https://addyosmani.com/blog/agent-harness-engineering/"
source: "addyosmani.com"
collection: "Research"
tags: [ai, agents]
highlight_colors: [yellow, purple]   ← the highlight colors used in this note
saved: 2026-06-16
cover: "https://…"
---



## Summary

…the AI-generated summary…

## Key questions

**A question the article answers**

…the AI-generated answer…

## Highlights


a passage you highlighted in Linkwise


*your annotation on that highlight*

## My notes
Write anything you want here — it's yours and survives every re-sync.

Each highlight renders as a colored block whose left bar matches the color you used in Linkwise (yellow, purple, pink, blue, or green), with a faint tint behind it. Any annotation you wrote appears in italics just beneath.

Cover image: When Linkwise has a cover image for the article, it's shown at the top of the note, sized to fit with rounded corners. Prefer text-only notes? Turn off Show cover image in settings. (A few links have no cover — those notes simply start at the Summary.)

The highlight_colors property lists the colors present in a note, so you can find notes by color:

• Search: ["highlight_colors":yellow] in the search bar.
• Dataview: FROM "Linkwise" WHERE contains(highlight_colors, "yellow")
• Bases / Properties view: filter or group on the highlight_colors property.

Everything above ## My notes is managed by Linkwise (frontmatter, the source callout, summary, and highlights). Linkwise keeps this up to date on every sync.

Everything from ## My notes down is yours. Write your own thoughts, add sections, link to other notes - it's preserved forever. Just keep the ## My notes heading in place as the divider.

You can freely rename or move notes; they're matched by linkwise_id, not the filename.

Note: don't edit or remove the linkwise_id field - it's how the plugin tracks each note. Deleting it can cause a duplicate to be created on the next sync.

• Check status: the Integrations card in the app shows "Last synced …" and your token prefix.
• Disconnect / revoke: Linkwise app → Integrations → Revoke. The plugin stops syncing immediately; notes already in your vault stay put.
• Re-pull everything: Obsidian → Settings → Linkwise → Reset sync state → Sync now.

• No telemetry or analytics - the plugin only talks to the Linkwise sync API.
• Your token is stored in the plugin's data.json, inside your vault. If your vault is synced/shared, the token travels with it - it's read-only and revocable anytime from the app. Treat it like a password.
• If the same vault syncs across devices, run Linkwise sync on one primary device to keep writes tidy.