Skip to content
Hoard Hoard

hoard init

The hoard init command runs an interactive wizard to configure Hoard.

Usage

Terminal window
hoard init [options]

Options

OptionDescription
--quickAccept all defaults, minimal prompts
--vectorsEnable semantic search (downloads embedding model)
--connector <name>Add a specific connector type

Examples

Full Interactive Wizard

Terminal window
hoard init

Walks through:

  1. Data source selection (including agent inbox)
  2. Folder selection (if local files selected)
  3. File type configuration (if local files selected)
  4. Vector search option
  5. Background sync schedule (optional)
  6. File watcher (optional)

Then optionally runs AI tool setup.

Quick Setup

Terminal window
hoard init --quick

Uses defaults:

  • Local files connector enabled
  • Common document folders detected
  • Default file extensions
  • Vectors disabled
  • Background sync schedule enabled (15 min)
  • File watcher disabled
  • No AI tool configuration

Enable Vectors

Terminal window
hoard init --vectors

Same as full wizard but pre-selects vector search.

Add Specific Connector

Terminal window
hoard init --connector obsidian

Adds just the Obsidian connector without full wizard.

Wizard Flow

Step 1: Data Sources

What do you want to index?


  [x] Local files (markdown, text, code)
  [ ] Agent inbox (drop folder)
  [ ] Obsidian vault
  [ ] Browser bookmarks
  [ ] Notion export (CSV/HTML)

Step 2: Folders

Local files - pick folders to index


  Detected folders with documents:


  > ~/Documents/Notes          (42 files)
  > ~/Documents/Projects       (128 files)


  [ ] ~/Documents              (12,847 files) ⚠️ Large


  Or enter custom path: _____________

Step 3: File Types

File types to include


  1. Markdown
  2. Text
  3. CSV
  4. JSON
  5. YAML
  6. reStructuredText


Select file types (comma-separated) [1,2,3,4,5,6]:

Supported file types are .md, .txt, .csv, .json, .yaml, and .rst.

Enable semantic search?


    Yes, enable semantic search (downloads 90MB model)
  > No, use keyword search only (faster, no download)

Background Sync Schedule

Enable background sync schedule? [Y/n]:
Sync interval (minutes) [15]:

File Watcher

Enable file watcher for live updates? [y/N]:

AI Tools (Optional)

After the main wizard:

Configure AI tools now? [Y/n]:

The default is Yes. If confirmed, runs hoard setup --all to configure detected AI tools.

Orchestrator (Beta) (Optional)

After hoard init, you can initialize Orchestrator settings:

Terminal window
hoard orchestrate init

This generates a registration token and configures artifact storage.

Output

After completion:

✓ Config saved to ~/.hoard/config.yaml
✓ Database ready at ~/.hoard/hoard.db


Running initial sync...
Syncing local_files...
  Entities: 156, Chunks: 423, Tombstoned: 0, Errors: 0

If AI tool setup was selected, the setup output follows.

Generated Config

Creates ~/.hoard/config.yaml:

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


  inbox:
    enabled: true
    path: ~/.hoard/inbox
    include_extensions:
      - .md
      - .txt
      - .csv


vectors:
  enabled: false


sync:
  interval_minutes: 15
  watcher_enabled: false
  watcher_debounce_seconds: 2


memory:
  default_ttl_days: 30
  prune_on_sync: true


server:
  host: "127.0.0.1"
  port: 19850

Reconfiguring

Run hoard init again to modify configuration. The wizard runs through all steps and overwrites the existing configuration with your new selections.

See Also