Skip to content
Hoard Hoard

hoard instructions

The hoard instructions command injects a canonical Hoard guidance block into agent instruction files.

Usage

Terminal window
hoard instructions [options]

Options

OptionDescription
--allUpdate all targets (CLAUDE.md, AGENTS.md, OpenClaw SKILL.md)
--claudeUpdate project Claude instructions
--codexUpdate project Codex instructions
--openclawUpdate OpenClaw skill instructions
--root <path>Explicit project root for CLAUDE.md and AGENTS.md
--dry-runShow planned updates only
--yesApply without confirmation

What It Writes

Hoard inserts an idempotent marker block:

<!-- HOARD:START -->
...
<!-- HOARD:END -->

If the block already exists, Hoard replaces it in place. If multiple blocks exist, Hoard collapses them into one canonical block.

Root Detection

For project files (CLAUDE.md, AGENTS.md), Hoard resolves root in this order:

  1. --root value (if provided)
  2. Nearest parent containing .git
  3. Current directory only if it contains a supported project manifest

If no valid root is found, Hoard exits with an error and prints the exact remediation command.

Examples

Preview updates for Codex and Claude

Terminal window
hoard instructions --codex --claude --dry-run

Apply all targets without prompt

Terminal window
hoard instructions --all --yes

Apply for a specific repo path

Terminal window
hoard instructions --claude --codex --root /path/to/repo

Golden Path Guidance

The injected block is intentionally short:

  • Stable fact/preference: memory_write
  • Durable note/document: inbox_put
  • File-based changes not visible yet: sync

Advanced lifecycle tools (memory_supersede, memory_retract, conflict/duplicate tools) are linked from the block.

See Also