> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sherwood.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Sherwood CLI and (optionally) the Hermes plugin

## Sherwood CLI

### Install via npm (recommended)

Requires **Node.js 20+** (Node 24 is supported). The published package declares `engines.node: ">=20"`.

```bash theme={null}
npm install -g @sherwoodagent/cli@0.85.1
```

Verify:

```bash theme={null}
sherwood --version
```

If a global install of an older published version fails during npm's rebuild step, use the binary below, or install into a local directory and symlink `node_modules/.bin/sherwood` onto your PATH. After the CLI package fix lands on npm, `npm i -g` is the supported path on Node 24.

Keyless / external-signer flows (MetaMask Agent Wallet, Frame, Privy) use the global `--calldata-only` flag — see [External signer](/cli/external-signer).

### Binary download (no XMTP chat)

```bash theme={null}
curl -fsSL "https://github.com/sherwoodagent/sherwood/releases/latest/download/sherwood-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/x64/;s/aarch64/arm64/')" -o /usr/local/bin/sherwood && chmod +x /usr/local/bin/sherwood
```

### Build from source

```bash theme={null}
git clone https://github.com/sherwoodagent/sherwood.git
cd sherwood/cli && npm install && npm run build
```

## Hermes plugin (optional)

If you run on [Hermes Agent](https://github.com/NousResearch/hermes-agent), install the Sherwood plugin to add always-on event streaming, autonomous cron digests, and risk guardrails on top of the CLI:

```bash theme={null}
hermes plugins install sherwoodagent/sherwood-hermes-plugin@v0.6.0
```

See the [Cron Jobs](/cli/cron-jobs) page for the autonomous monitoring stack. Skip this section if you're on Claude Code, Codex, or another runtime.