Installation

Two minutes from zero to a verified vault query. The skill ships as an npm package and runs through npx — no global install required for most workflows.

Requirements

Node.js 20 or newer. The skill uses built-in fetch and modern crypto APIs.
npm or pnpm. Either works; npx is part of npm and is the preferred entry point.
Internet access on Base RPC endpoints. The skill ships with a built-in pool of free RPC endpoints with fallback. No setup needed unless you want to use your own.

Nothing else. The skill has no native dependencies, no system packages, no global state outside of OWS wallet files under ~/.ows/wallets/ (only created if you call create-wallet).

npx usage

The recommended way to use the skill is on-demand via npx. Every command pulls the latest published version automatically:

shell

npx @robotmoney/cli <command> [options]

The first invocation downloads the package; subsequent invocations run from the npx cache. Cold start is ~1 second; warm start is sub-100ms.

Pinning a version

For production / agent infrastructure, pin a version so behavior doesn't drift unexpectedly: npx @robotmoney/cli@0.4.2 health-check --chain base. Otherwise npx always pulls the latest tagged release.

Global install

If you call the skill frequently and don't want npx in the command, install it globally:

shell

npm install -g @robotmoney/cli
robotmoney-cli health-check --chain base

Global install creates a binary on your PATH named robotmoney-cli. Upgrade with npm update -g @robotmoney/cli.

First command

Confirm the skill is reachable and the vault is healthy with a single no-auth call:

shell

npx @robotmoney/cli health-check --chain base

Expected response (formatted):

json

{
  "chain": "base",
  "chainId": 8453,
  "vault": "0x4f835c9f54bcf17daf9040f60cb72951ccbb49dd",
  "rpc": {
    "url": "<one of the built-in endpoints>",
    "blockNumber": 26831245,
    "latencyMs": 412
  },
  "vaultState": {
    "totalAssets": "84320.12",
    "totalShares": "84102.55",
    "sharePrice": "1.0026",
    "paused": false,
    "shutdown": false,
    "adapters": {
      "active": 3,
      "names": ["Morpho", "Aave", "Compound"]
    }
  },
  "ok": true
}

If ok is true you're ready to use the read commands. If it's false, the response contains a reason field — usually a transient RPC failure (retry) or a paused vault (operator attention needed).

As a Claude Code skill

The skill is published as a Claude Code skill in the robotmoney/robotmoney-skills marketplace plugin. To install:

shell

claude plugin install robotmoney/robotmoney-skills

Once installed, Claude Code sessions can invoke the skill directly via natural language — "What's rmUSDC yielding right now?", "Deposit 100 USDC into Robot Money", "Withdraw my position" — and Claude will translate the request into the appropriate CLI command, parse the JSON response, and present the relevant detail to you.

The skill manifest tells Claude when to use it. See the live marketplace page or the skill repo for the manifest source.

Environment variables

The skill reads a small number of optional environment variables. None are required for read commands; some affect execute-* commands when an OWS wallet is involved.

Variable	Purpose
`RPC_URL`	Override the built-in RPC pool with your own endpoint. Same as passing `--rpc-url`.
`OWS_PASSPHRASE`	Passphrase for unlocking an OWS wallet during `execute-*` calls. Cleanest option for agent workflows; avoids exposing the passphrase in command history or requiring a TTY prompt.
`OWS_WALLETS_DIR`	Override the default OWS wallet location (`~/.ows/wallets/`). Useful for containerized agents.

Upgrading

The skill is in active development (pre-v1.0). For npx users, every fresh invocation already pulls the latest release. For globally-installed users:

shell

npm update -g @robotmoney/cli

Changelog and release notes live in the robotmoney-skills repo. Breaking changes are flagged in release notes; we don't rename commands or change response shapes without a major version bump.