Skip to content
Hoard Hoard

hoard sync

The hoard sync command triggers a sync from all configured data sources.

Usage

Terminal window
hoard sync [options]

Options

OptionDescription
--config <path>Use alternate config file

Examples

Sync All Sources

Terminal window
hoard sync

Syncs all enabled connectors.

Output

$ hoard sync


Syncing local_files...
  Entities: 251, Chunks: 820, Tombstoned: 0, Errors: 0
Syncing obsidian...
  Entities: 356, Chunks: 1325, Tombstoned: 2, Errors: 0

Sync Process

For each enabled connector:

  1. Scan — Find all items in source
  2. Compare — Check content hashes for changes
  3. Process — Chunk new/modified content
  4. Index — Update database and FTS
  5. Tombstone — Mark missing items as deleted

Change Detection

Hoard uses content hashes to detect changes:

  • Unchanged — Skip (fast)
  • Modified — Re-chunk and re-index
  • New — Process and add
  • Deleted — Tombstone (soft delete, persists indefinitely)

Background Sync and Watcher

Hoard can sync automatically while the server is running (hoard serve or hoard mcp serve).

Configure in ~/.hoard/config.yaml:

sync:
  interval_minutes: 15    # 0 to disable scheduled sync
  watcher_enabled: false  # Enable file watcher
  watcher_debounce_seconds: 2

Connector Status

Check what’s been synced:

Terminal window
hoard connectors status
Connector         Enabled   Entities   Last Sync
local_files       yes       1,200      2026-02-03T10:15:00
obsidian          yes       1,256      2026-02-03T10:15:00
notion_export     yes       98         2026-02-03T10:15:00

Troubleshooting

Sync Taking Too Long

  • Reduce paths in config
  • Narrow down include_extensions to only needed file types

Missing Content

  1. Check file extensions: include_extensions in config
  2. Verify path exists
  3. Run hoard doctor to diagnose

Sync Errors

Check the console output for detailed error messages for each file.

See Also