Obsidian ↔ Linear Sync Plugin
Integration
Elevator pitch
Bidirectional sync between Obsidian notes and Linear issues. Free tier = one-way Linear → Obsidian pull. Pro tier = full bidirectional sync with conflict resolution.
Why this product
- I am the target customer (Linear + Obsidian user, daily driver).
- No good existing plugin covers this pair — closest is a dormant one-way Linear → Notion bridge.
- Obsidian community discovers and shares plugins aggressively (2M+ users via the official community-plugins repo).
- No backend required → low ops overhead for the portfolio.
Architecture (summary)
- Runtime: Obsidian plugin (TypeScript, compiled with esbuild) running client-side on user's machine.
- Auth: User supplies a Linear personal API key in plugin settings. Stored in Obsidian's config (local machine only).
- Linear client: Typed GraphQL client with exponential-backoff retry on rate limits and DataLoader-style batching.
- Content conversion: Bidirectional Markdown ↔ Linear ProseMirror JSON converter with unit tests covering code blocks, nested lists, mentions, and attachments.
- Sync engine: Pull every N minutes + manual trigger. Push on debounced file save. Last-write-wins conflict resolution with a user prompt on divergence >24h.
- License: HMAC-signed license keys, validated offline. Stripe Payment Link → Cloudflare Worker webhook → license email.
Free vs Pro
| Feature | Free | Pro |
|---|---|---|
| One-way Linear → Obsidian pull | ✅ | ✅ |
| Multi-team sync | ❌ | ✅ |
| Two-way sync (Obsidian → Linear) | ❌ | ✅ |
| Conflict resolution UI | — | ✅ |
| YAML template library | ❌ | ✅ |
Pricing
Pro: $29 one-time OR $4/mo (user choice at checkout). €500/mo target = ~125 monthly subs OR sustained ~17 one-time sales/month.
Definition of success
- v0.1 (MVP, free-only): 500+ installs in 30 days post-submission to Obsidian community-plugins repo.
- v1.0 (Pro launch): 3%+ paid conversion → ~15 paid subs in first month of Pro tier.
- Kill criteria: <50 installs after 30 days post-submission OR 0 paid conversions after 60 days of Pro availability.
Distribution
- Submit to Obsidian community-plugins repo (official GitHub PR process, ~1 week review).
- Post to r/ObsidianMD launch thread.
- Post in Obsidian Discord #plugin-showcase.
- Share in Linear's community Slack and indie productivity Twitter.
- Updated
- 2026-04-22