The intelligence & security layer
for AI agents

Download the plugin

Download the Datagran Obsidian plugin zip. This contains main.js, manifest.json, and styles.css.

The “Copy instructions for AI” button copies a markdown guide to your clipboard. Paste it into ChatGPT, Claude, or any AI assistant and it will walk you through finding the zip, locating your vault, and installing the plugin.

Install into Obsidian

Find your vault's location. On macOS you can check ~/Library/Application Support/obsidian/obsidian.json — vaults are often in iCloud (~/Library/Mobile Documents/iCloud~md~obsidian/Documents/), not ~/Documents.

Unzip the download into your vault's plugin folder. Create the plugins/ folder if it doesn't exist yet:

mkdir -p "/path/to/your-vault/.obsidian/plugins/datagran-obsidian"
unzip -o ~/Downloads/datagran-obsidian-v0.1.0.zip \
  -d "/path/to/your-vault/.obsidian/plugins/datagran-obsidian/"

# Verify files are directly inside (not nested in a subfolder):
ls /path/to/your-vault/.obsidian/plugins/datagran-obsidian/
# → main.js  manifest.json  styles.css

Then open Obsidian → Settings → Community plugins → turn off Restricted mode if prompted → enable Datagran Wiki Sync. You may need to restart Obsidian if the plugin doesn't appear.

Create a sync target + token

Use your Datagran API key to create a sync target and mint a plugin token. You'll need the target ID and token for the plugin settings.

# Create a sync target
curl -X POST 'https://YOUR_DATAGRAN_URL/api/context/obsidian/targets' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "end_user_external_id": "user_123",
    "name": "My Vault",
    "root_folder": "Datagran"
  }'
# Returns: { "target": { "id": "TARGET_UUID", ... } }

# Mint a plugin token
curl -X POST 'https://YOUR_DATAGRAN_URL/api/context/obsidian/plugin-sessions' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "end_user_external_id": "user_123",
    "target_id": "TARGET_UUID"
  }'
# Returns: { "token": "dgo_abc123...", "expires_at": "..." }

Configure the plugin

In Obsidian, go to Settings → Datagran Wiki Sync and fill in:

Sync

Press Ctrl+P (or Cmd+P on Mac) and run Datagran: Sync now. Your vault will get:

Datagran/
  index.md              # Auto-generated index with [[wikilinks]]
  log.md                # Sync event log
  topics/
    acme-pricing.md     # Compiled wiki pages
    customer-success.md
  entities/
    zenith-competitor.md
  analysis/
    churn-2025.md

Every subsequent sync only transfers files that changed since the last sync. The plugin tracks a cursor internally so you never re-download unchanged pages.