Connectors Overview

Connectors are plugins that import data from various sources into Hoard’s unified index.

Built-in Connectors

Connector	Source	Description
`local_files`	Filesystem	Markdown, text, CSV, JSON files
`inbox`	Filesystem	Agent inbox drop folder
`obsidian`	Obsidian	Obsidian vaults
`bookmarks_chrome`	Chrome	Browser bookmarks
`bookmarks_firefox`	Firefox	Browser bookmarks
`notion_export`	Notion	Workspace export (ZIP/HTML/CSV)

Configuration

Connectors are configured in ~/.hoard/config.yaml:

connectors:
  local_files:
    enabled: true
    paths:
      - ~/Documents/Notes
    include_extensions:
      - .md
      - .txt

  inbox:
    enabled: true
    path: ~/.hoard/inbox

  obsidian:
    enabled: true
    vault_path: ~/Obsidian

  bookmarks_chrome:
    enabled: true

Quick Add

Add sources without editing config:

# Add folder
hoard add ~/Documents/Notes

# Add inbox folder
hoard add --inbox ~/.hoard/inbox

# Add Obsidian vault
hoard add --obsidian ~/Obsidian

# Add Notion export
hoard add --notion ~/Downloads/notion-export

Checking Status

hoard connectors status

Connector         Enabled   Entities   Last Sync
local_files       yes       1,200      2026-02-03T10:15:00Z
inbox             yes       12         2026-02-03T10:15:00Z
obsidian          yes       1,256      2026-02-03T10:15:00Z
bookmarks_chrome  yes       89         2026-02-03T10:15:00Z

Sync Behavior

Full Sync

Each sync:

Scans all items in source
Compares content hashes
Updates changed items
Tombstones deleted items

Change Detection

Status	Action
New	Index and chunk
Modified	Re-chunk and update
Unchanged	Skip
Deleted	Tombstone

Chunking

All connectors use the same whitespace-based token chunking:

Text is split into tokens using whitespace regex (\S+)
Chunks target chunk_max_tokens tokens (default: 400)
Adjacent chunks overlap by chunk_overlap_tokens (default: 50)

Building Custom Connectors

See the Connector SDK for building your own connectors.

Next Steps

Local Files — Filesystem configuration
Agent Inbox — Drop-folder ingestion
Obsidian — Obsidian vault configuration
Connector SDK — Build your own connector