CLI Overview

Hoard provides a comprehensive CLI for setup, management, and interaction.

Command Structure

hoard <command> [options] [arguments]

Available Commands

Core Commands

Command	Description
`init`	Interactive setup wizard
`add`	Add data sources
`sync`	Sync content from sources
`search`	Search indexed content
`serve`	Start MCP server
`setup`	Configure AI tools
`instructions`	Inject Hoard memory/sync guidance into agent instruction files
`doctor`	Diagnose issues

Command Groups

Group	Subcommands	Description
`memory`	`put`, `get`, `search`, `prune`	Manage memory entries
`tokens`	`add`, `list`, `remove`	Manage API tokens
`orchestrate`	`init`	Orchestrator setup (Beta)
`agent`	`register`, `list`, `deregister`	Agent registry (Beta)
`task`	`create`, `list`, `poll`, `claim`, `complete`	Task management (Beta)
`artifact`	`put`, `get`, `list`	Task artifacts (Beta)
`event`	`publish`, `poll`	Events (Beta)
`cost`	`summary`, `budget`	Cost reporting (Beta)
`workflow`	`list`, `create`, `start`, `status`	Workflows (Beta)
`connectors`	`status`, `check`, `inspect`	Connector management
`embeddings`	`build`	Build vector embeddings
`mcp`	`serve`, `stdio`	MCP server modes

Aliases

Alias	Equivalent
`sync-status`	`connectors status`

Quick Reference

Setup Commands

hoard init                    # Full interactive wizard
hoard init --quick            # Accept defaults
hoard init --vectors          # Enable semantic search
hoard add <path>              # Add folder
hoard add --obsidian <path>   # Add Obsidian vault
hoard add --notion <path>     # Add Notion export
hoard add --inbox <path>      # Set agent inbox folder

Sync & Search

hoard sync                          # Sync all sources
hoard search "query"                # Search content
hoard search "query" --limit 5
hoard search "query" --types entity,memory
hoard search "query" --no-memory

Server Management

hoard serve                   # Start HTTP server
hoard serve --allow-remote    # Allow non-loopback bind
hoard serve --daemon          # Run in background
hoard serve --status          # Check status
hoard serve --stop            # Stop daemon
hoard serve --install-autostart

Client Setup

hoard setup --all             # Configure all clients
hoard setup --claude          # Claude Code only
hoard setup --codex           # Codex only
hoard setup --openclaw        # OpenClaw only
hoard setup --verify          # Test integrations
hoard setup --uninstall <client>
hoard setup --no-instructions # Skip instruction injection
hoard setup remote --url https://hoard.example.com --token hoard_sk_... --codex
hoard setup remote --url https://hoard.example.com --admin-token <admin> --all

Instruction Injection

hoard instructions --all
hoard instructions --codex --claude --dry-run
hoard instructions --codex --claude --yes

Orchestrator (Beta)

hoard orchestrate init
hoard agent register demo-agent --type worker
hoard task poll
hoard workflow list

Diagnostics

hoard doctor                  # Health check
hoard connectors status       # Connector status
hoard connectors check <name> # Check specific connector
hoard sync-status             # Alias for connectors status

Token Management

hoard tokens add <name>       # Create token
hoard tokens list             # List tokens
hoard tokens remove <name>    # Remove token

Memory

hoard memory put <key> <content>  # Store memory entry
hoard memory get <key>            # Retrieve memory entry
hoard memory search <query>       # Search memory entries
hoard memory prune                # Delete expired entries

Embeddings

hoard embeddings build        # Build vector embeddings
hoard embeddings build --source obsidian  # Build for specific source

Command Options

Option	Description
`--help`	Show help for any command
`--config <path>`	Use alternate config file (available on most commands)

Note: --config is a per-command option, not a global option. It must come after the command name:

hoard sync --config /path/to/config.yaml

Configuration File

Default location: ${HOARD_DATA_DIR:-~/.hoard}/config.yaml

Exit Codes

Code	Meaning
0	Success
1	Error

Getting Help

hoard --help              # General help
hoard <command> --help    # Command-specific help

Next Steps

Explore individual commands:

hoard init - Setup wizard
hoard instructions - Manage instruction injection
hoard serve - Server management
Orchestrator commands - Agents, tasks, workflows (Beta)