hoard add

The hoard add command adds data sources without running the full wizard.

Usage

hoard add <path> [options]
hoard add --obsidian <path>
hoard add --notion <path>
hoard add --inbox <path>

Options

Option	Description
`--obsidian <path>`	Add path as Obsidian vault
`--notion <path>`	Add path as Notion export
`--inbox <path>`	Set agent inbox folder

Examples

Add a Folder

hoard add ~/Documents/Notes

Adds the folder to local_files connector and syncs.

Add Obsidian Vault

hoard add --obsidian ~/Obsidian

Configures the Obsidian connector and syncs.

Add Notion Export

hoard add --notion ~/Downloads/notion-export

Adds a Notion workspace export directory.

Set Agent Inbox

hoard add --inbox ~/.hoard/inbox

Enables the inbox connector and sets the drop folder.

Behavior

Local Files

When adding a path without flags:

Checks if path looks like a Notion export (prompts to confirm)
Adds path to connectors.local_files.paths
Runs sync

Obsidian

When using --obsidian:

Sets connectors.obsidian.vault_path
Enables Obsidian connector
Runs sync

Notion Export

When using --notion:

Sets connectors.notion_export.export_path
Enables Notion connector
Runs sync

Inbox

When using --inbox:

Sets connectors.inbox.path
Enables Inbox connector
Creates the folder if it does not exist
Runs sync

Output

$ hoard add ~/Documents/Notes

Updated config at ~/.hoard/config.yaml
Syncing local_files...
  Entities: 42, Chunks: 156, Tombstoned: 0, Errors: 0

Detection

hoard add detects Notion exports automatically:

Pattern	Auto-Detection
`*.zip` with “notion” in name	Prompts for `--notion` confirmation
Folder with `.html`/`.md`/`.csv` Notion structure	Prompts for `--notion` confirmation
Regular folder	Adds to `local_files`

Configuration Changes

After running, check your config:

cat ~/.hoard/config.yaml

Example result:

connectors:
  local_files:
    enabled: true
    paths:
      - ~/Documents/Notes    # Added
      - ~/Documents/Work     # Existing

  obsidian:
    enabled: true
    vault_path: ~/Obsidian   # Added with --obsidian

  inbox:
    enabled: true
    path: ~/.hoard/inbox     # Added with --inbox