drive9

Sync your Obsidian vault across devices through drive9 — keep every note in sync, search by meaning, and make your knowledge accessible to AI agents.

Why drive9?

• Sync across devices — edit on desktop, pick up on mobile. Real-time SSE on desktop, battery-friendly polling on iOS/Android.
• Shared workspace — multiple people (or AI agents) can read and write the same vault through the drive9 server.
• Search by meaning — hybrid search combines full-text, vector, and keyword matching so you find notes by what they mean, not just exact words.
• AI-ready — your vault is always accessible to AI agents and tools via the drive9 API, enabling workflows like automated summarization, Q&A, and knowledge retrieval.

Screenshots

Setup	Connected

Semantic search	Sync status

Features

• Bidirectional sync — local changes push to drive9; remote changes pull automatically.
• Conflict resolution — 3-way merge with shadow store; binary files get .conflict copies.
• Semantic search — command palette "Search" opens a modal powered by drive9's hybrid search.
• Large file support — files over 50 KB use multipart upload with progress indication.
• Mobile compatible — works on iOS and Android.
• i18n — English and Simplified Chinese built in.

Setup

1. Install the plugin from Obsidian Community Plugins (search "drive9") or manually copy main.js, manifest.json, and styles.css to your vault's .obsidian/plugins/drive9/ directory.
2. Open Settings > drive9.
3. Click Create Account to provision a new drive9 workspace, or paste an existing API Key.
4. Sync starts automatically after the first-run reconciliation.

First-run behavior

On first launch, the plugin detects whether files exist locally, remotely, or both:

• Local-only vault — uploads all files to drive9.
• Remote-only files — downloads from drive9.
• Both exist — reconciles by comparing files and syncing differences.

Settings

Security

• API key is stored in .obsidian/plugins/drive9/data.json — ensure .obsidian/ is in your .gitignore if your vault is a git repo.
• The plugin warns you in settings if .gitignore doesn't cover .obsidian/.
• Error messages are sanitized to strip Bearer tokens before display.

Commands

Network and data disclosure

This plugin connects to an external drive9 server (default: https://api.drive9.ai) to sync your vault files. Specifically:

• Network requests: the plugin sends your vault files to the configured drive9 server for storage and retrieval. All communication uses HTTPS.
• Account required: a drive9 account and API key are required. You can create a free account directly from the plugin settings.
• No telemetry: the plugin does not collect analytics or telemetry data.
• No files outside the vault: the plugin only reads and writes files within your Obsidian vault directory.

Requirements

• Obsidian 1.5.0 or later
• A running drive9 server with a valid API key

Development

npm install
npm run dev      # Watch mode
npm run build    # Production build

License

MIT