hoard setup

The hoard setup command group configures AI tools to connect to Hoard.

Usage

hoard setup [options]               # local server setup (default)
hoard setup remote [options]        # remote server setup

Options

Option	Description
`--all`	Configure all detected AI tools
`--claude`	Configure Claude Code
`--claude --project-scope`	Claude Code with env var
`--codex`	Configure Codex
`--openclaw`	Configure OpenClaw
`--verify`	Test all integrations
`--uninstall <client>`	Remove integration
`--no-instructions`	Skip automatic instruction injection

Remote Subcommand Options

Option	Description
`--url <https://...>`	Remote Hoard URL (base URL or `/mcp`)
`--token <token>`	Recommended: use existing scoped token
`--admin-token <token>`	Advanced automation: auto-provision per-client tokens
`--dry-run`	Print actions without writing files
`--claude`, `--codex`, `--openclaw`, `--all`	Same client selection flags as local setup
`--project-scope`	Claude project-scope mode

Instruction Injection Behavior

After client config, hoard setup can inject a Hoard guidance block into agent instruction files:

Claude target: CLAUDE.md (or claude.md if already present)
Codex target: AGENTS.md (or agents.md if already present)
OpenClaw target: ~/.openclaw/skills/hoard/SKILL.md

Behavior:

Interactive session: shows one confirmation prompt before writing
Non-interactive session: skips writing and prints the follow-up hoard instructions ... command
Use --no-instructions to disable this step

Examples

Configure All Tools

hoard setup --all

Detects and configures all AI tools found on the system.

Configure Codex and Skip Instruction Injection

hoard setup --codex --no-instructions

Re-run Instruction Injection Manually

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

Configure Claude Code

hoard setup --claude

Creates ~/.claude.json with inline token (user-scope).

Claude Code with Environment Variable

hoard setup --claude --project-scope

Creates .mcp.json using ${HOARD_TOKEN} (for teams).

Configure Codex

hoard setup --codex

Creates/updates ~/.codex/config.toml.

Configure OpenClaw

hoard setup --openclaw

Installs bundled skill to ~/.openclaw/skills/hoard/.

Verify All Integrations

hoard setup --verify

Runs integration checks.

Remove Integration

hoard setup --uninstall openclaw

Verification Output

$ hoard setup --verify

Tier 1: Hoard Server Health
  ✓ Server responding: http://127.0.0.1:19850
  ✓ Tools available

Tier 2: Client Configs
  ✓ Claude Code: ~/.claude.json
  ✓ Codex: ~/.codex/config.toml

Tier 3: OpenClaw Skill
  ✓ OpenClaw SKILL.md: ~/.openclaw/skills/hoard/SKILL.md
  ✓ OpenClaw config: ~/.openclaw/openclaw.json

The verification checks:

Server health (responds to HTTP requests)
Tools list availability (when HOARD_TOKEN is set)
Config file existence for each client

Remote Setup

Recommended Flow (Scoped Token)

Create a token on the server:

hoard tokens add codex-laptop --scopes search,get,memory,sync,ingest

Configure the client machine:

hoard setup remote --url https://hoard.example.com --token hoard_sk_... --codex

Advanced Automation Flow (Admin Token)

hoard setup remote --url https://hoard.example.com --admin-token YOUR_ADMIN_SECRET --all

This auto-provisions one token per selected client type.