x-Mark

X/Twitter bookmarks to Obsidian. Sync, link, and explore your bookmarks with the Obsidian graph view.

x-Mark syncs your X/Twitter bookmarks and exports them as linked markdown notes.
The wiki links create a knowledge graph you can explore in Obsidian.

Features

• 📥 Sync - Download your X bookmarks (uses browser session or API)
• 📄 Obsidian Export - Generate linked markdown notes with frontmatter
• 🔗 Wiki Links - Auto-generated [[links]] between related bookmarks
• 🏷️ AI Classification - Categorize with Ollama Cloud (Nemotron Super 120B)
• 🕸️ Graph View - See clusters of related content in Obsidian

Install

npm install -g x-mark

Requires Node.js 20+

Quick Start

# 1. Sync your bookmarks (needs browser logged into X)
xmark sync

# 2. Export to Obsidian vault
xmark export

# 3. Classify with AI
xmark classify

# 4. Open Obsidian - enable Graph View to explore connections!

Commands

Command	Description
xmark sync	Sync bookmarks from X
xmark export	Export to Obsidian vault
xmark classify	Classify with Ollama AI
xmark link	Generate wiki links
xmark config show	Show configuration
xmark config vault <path>	Set Obsidian vault
xmark status	Show sync status

How It Works

┌─────────────┐     ┌─────────────┐     ┌─────────────────┐
│   X/Twitter │────▶│   x-Mark    │────▶│    Obsidian      │
│  Bookmarks  │     │   (sync)    │     │  (your vault!)   │
└─────────────┘     └─────────────┘     └─────────────────┘
                                            │
                                            ▼
                                    ┌─────────────────┐
                                    │   Graph View   │
                                    │  See clusters  │
                                    └─────────────────┘

Wiki Links Generated

• [[@username]] - Links to author pages
• [[domain:github.com]] - Links to subject domains
• [[category/research]] - Links to categories
• [[related-notes]] - Links between similar bookmarks

Configuration

# Set your Obsidian vault path
xmark config vault ~/Obsidian/X-Bookmarks

# Set Ollama model
xmark config model nvidia/nemotron-super-120b

Architecture

src/
├── cli.ts           # Main CLI commands
├── bookmarks.ts     # X sync engine
├── ollama.ts        # Ollama Cloud client
├── markdown.ts      # Bookmark → Markdown conversion
├── wiki-links.ts   # Wiki link generation
├── preferences.ts   # User config
└── paths.ts        # Data directory paths

Obsidian Vault Structure

~/Obsidian/X-Bookmarks/
├── Bookmarks/           # Individual bookmark notes
│   ├── 2024-01-15-user-interesting-post.md
│   └── ...
├── Authors/             # Author index notes
├── Domains/             # Domain index notes
└── [[Graph View]]       # Enable in Obsidian settings

License

MIT