04-tooling

link cli agent wallet setup

Tue Apr 28 2026 20:00:00 GMT-0400 (Eastern Daylight Time) ·tooling ·status: active

Link CLI agent wallet — setup record

Stripe’s Link CLI installed on the Mac mini 2026-04-29 to give Ray (RDCO COO Agent) a per-charge agent payment capability. End-to-end loop verified via test-mode dry run.

What’s wired

Per-charge contract

Setting in stone so Ray future-iterations don’t drift:

  1. Ray surfaces the spend on iMessage first (“about to create a $X spend request for Y, you’ll see the Link prompt”). Heads-up is courtesy; not the gate.
  2. Ray runs link-cli spend-request create with merchant + amount + ≥100-char context.
  3. Founder’s Link app shows the push notification. Founder taps approve or deny.
  4. On approve, Ray retrieves a single-use credential — a one-time card (or Shared Payment Token for HTTP-402 endpoints) tied to the chosen payment method. Card dies after the merchant charge OR after valid_until timestamp (~1 hour).
  5. Ray plugs the credential into the merchant’s checkout and the charge happens.

No autonomous spend. No standing balance. No card stored on Ray’s side.

Failure / safety modes

npm install gotcha (record for future fresh-Mac restoration)

The Mac mini’s ~/.npmrc has min-release-age set as a supply-chain protection — it filters out npm packages published more recently than ~1 week. This blocked the install of Link CLI 0.4.0 (published the same day, 2026-04-29). Workaround used:

NPM_CONFIG_MIN_RELEASE_AGE=0 npm install -g @stripe/link-cli@latest

Per-command env-var override; no persistent config change. Documented here so a fresh-Mac bootstrap reproduces the same outcome cleanly. The supply-chain protection is intentional and remains in effect for all OTHER package installs.

Test-mode dry run (verification)

Performed 2026-04-29 23:42 UTC.

What this enables

Concrete near-term use cases where Ray would create a real spend request (each pending founder go-ahead at the moment):

Strategic context — why this matters now

The agent-wallet rail is commodifying fast (Stripe Link, x402 from Coinbase+CF, Skyfire, Crossmint, Mastercard/Visa programs all racing). RDCO’s wedge is NOT in building wallets — it’s the upstream layer:

Setting up Link for Ray is BOTH a useful operating capability AND first-hand experience for advising enterprise clients (phData) on agent-purchase governance. The test loop we just ran is the same primitive an enterprise would deploy at scale; the governance question is what we’d help them solve.