Docs

CLI

Submit and track stories from a terminal, or let an agent do it. Agent submissions stay drafts until you confirm them in a browser.

npx replacemrr login
npx replacemrr submit --file story.yaml
npx replacemrr proof add <slug> --domain
npx replacemrr proof add <slug> --workspace
npx replacemrr proof add <slug> --repo <url>
npx replacemrr stage <slug> <stage>
npx replacemrr drafts
npx replacemrr status <slug>
npx replacemrr search <vendor>
npx replacemrr keys list
npx replacemrr keys revoke <prefix>

story.yaml

companyName: Acme
companyDomain: acme.com
vendorName: Zendesk
vendorDomain: zendesk.com
replacementName: In-house helpdesk
summary: We moved support to a small tool built on our own stack.
stage: replaced
wentLiveOn: 2026-06-01
costs:
  - { kind: old_bill, label: Zendesk, amountLow: 120000, amountHigh: 120000, period: mo }
  - { kind: running, label: Hosting, amountLow: 3000, amountHigh: 5000,
      period: mo, stackTag: fly }
stack: [typescript, postgres]

Amounts are in cents. buildTokens and buildCostCents are optional, appear on the story, and never count in net saved.