remit-cli-0.5.5 is not a library.

remit-cli

Skill MD · Docs · Agent Spec

Command-line interface for Remit — USDC payments for AI agents on Base.

Install

Homebrew (macOS / Linux)

brew install remit-md/tap/remit

Install script (Linux / macOS)

curl -fsSL https://remit.md/install.sh | sh

Prebuilt binary (Linux)

Static musl builds with zero dependencies — works on any Linux including Ubuntu 20.04+, Alpine, Colab, Docker scratch:

# x86_64
curl -fsSL https://github.com/remit-md/remit-cli/releases/latest/download/remit-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv remit /usr/local/bin/

# aarch64
curl -fsSL https://github.com/remit-md/remit-cli/releases/latest/download/remit-aarch64-unknown-linux-musl.tar.gz | tar xz
sudo mv remit /usr/local/bin/

Note: musl builds do not include OS keychain support. Use remit signer init --no-keychain for encrypted file storage.

Scoop (Windows)

scoop bucket add remit https://github.com/remit-md/scoop-bucket
scoop install remit

crates.io

cargo install remit-cli

Build from source

git clone https://github.com/remit-md/remit-cli.git
cd remit-cli
cargo install --path .

Setup

With CLI signer (default, recommended)

The CLI signer uses an encrypted keystore at ~/.remit/keys/. Private keys are AES-256-GCM encrypted at rest with scrypt KDF. SDKs call remit sign as a subprocess — no HTTP server, no ports, no network.

remit signer init                 # generates wallet + encrypted keystore
export REMIT_SIGNER_KEY=your-password

With OWS

OWS encrypts keys locally and evaluates spending policies before every signature.

remit init --ows                  # creates OWS wallet + policy + API key
export OWS_WALLET_ID=remit-my-agent
export OWS_API_KEY=<shown by init>

With a raw private key (legacy)

remit init --legacy --write-env   # generates key, saves to .env
# or
export REMITMD_KEY=0x<your-private-key>

Wallet Modes

The CLI supports three wallet modes. It checks them in priority order:

Priority	Mode	Env Var	Description
1	CLI signer	`REMIT_SIGNER_KEY`	Encrypted keystore. SDKs invoke `remit sign` via subprocess.
2	OWS	`OWS_WALLET_ID`	Encrypted local vault with spending policies. Requires OWS binary.
3	Raw key	`REMITMD_KEY`	Private key in environment. Simple but less secure.

If a keystore exists at ~/.remit/keys/default.enc and REMIT_SIGNER_KEY is set, the CLI signs in-process using the encrypted key. Otherwise it falls back to OWS, then raw key.

Quickstart

remit status                                          # Wallet info + balance
remit pay 0xRecipient 10.00                           # Send 10 USDC
remit tab open 0xProvider 100 --per-unit 2.50         # Open tab (100 USDC limit, 2.50/unit)
remit tab charge <tab-id> 2.50 --cumulative 2.50      # Charge 2.50 USDC
remit tab close <tab-id> --final-amount 5.00 --provider-sig 0x...  # Settle tab
remit wallet fund                                     # Open fund link in browser
remit --testnet mint 100                              # Mint 100 testnet USDC

Commands

Command	Description
`remit init`	Create CLI signer wallet (default), OWS (`--ows`), or raw key (`--legacy`)
`remit signer init`	Generate new wallet + encrypted keystore
`remit signer import --key 0x...`	Import an existing private key into keystore
`remit signer migrate`	Migrate V24 keystore (token-based) to V25 (password-based)
`remit sign --eip712`	Sign EIP-712 typed data from stdin (used by SDKs)
`remit sign --digest`	Sign raw 32-byte digest from stdin (used by SDKs)
`remit address`	Print wallet address from keystore (no password needed)
`remit update`	Self-update to latest version
`remit wallet list`	List all OWS wallets
`remit wallet fund`	Open fund link in browser
`remit wallet set-policy`	Configure spending limits
`remit status`	Wallet status and balance
`remit balance`	USDC balance
`remit pay <to> <amount>`	One-time payment
`remit tab open <provider> <limit> --per-unit <amount>`	Open a metered tab
`remit tab charge <id> <amount> --cumulative <total>`	Charge against tab
`remit tab close <id> --final-amount <amount> --provider-sig <sig>`	Close and settle tab
`remit tab get <id>`	Show tab details
`remit tab list`	List open tabs
`remit stream open/close`	Streaming payments
`remit stream list`	List active streams
`remit escrow create/release/cancel/claim-start`	Escrow
`remit escrow list`	List escrows
`remit bounty post/submit/award`	Bounties
`remit bounty list`	List bounties
`remit deposit create`	Deposit address
`remit fund [--amount <usdc>] [--name <name>] [--message <msg>]`	Generate fund link
`remit withdraw`	Generate withdraw link
`remit mint <amount>`	Mint testnet USDC (max 2500/hr)
`remit webhook create/list/delete`	Webhook subscriptions
`remit a2a discover/pay/card`	A2A agent discovery and payments
`remit config set/get/show`	Configuration
`remit completions <shell>`	Shell completions (bash, zsh, fish, powershell)

Global Flags

Flag	Description
`--json`	Machine-readable JSON output
`--testnet`	Use Base Sepolia testnet

`init` Flags

Flag	Description
`--name <NAME>`	Wallet name (default: `remit-{hostname}`)
`--chain <CHAIN>`	`base` or `base-sepolia` (default: `base`)
`--ows`	Use OWS wallet instead of CLI signer
`--legacy`	Skip signer/OWS, generate a raw private key instead
`--write-env`	(Legacy only) Write key to `.env` in current directory

`sign` Flags

Flag	Description
`--eip712`	Sign EIP-712 typed data (JSON on stdin)
`--digest`	Sign raw 32-byte digest (hex on stdin)
`--keystore <PATH>`	Keystore path (default: `~/.remit/keys/default.enc`)
`--password-file <PATH>`	Read password from file instead of `REMIT_SIGNER_KEY`

`tab` Flags

Subcommand	Flag	Description
`open`	`<provider> <limit>`	Provider address and USDC spending limit (positional, required)
`open`	`--per-unit <amount>`	Per-unit charge in USDC (required)
`open`	`--expiry <secs>`	Expiry in seconds from now (default: 86400)
`charge`	`<tab-id> <amount>`	Tab ID and charge amount (positional, required)
`charge`	`--cumulative <amount>`	Running cumulative total (required)
`charge`	`--call-count <n>`	Call count for this charge (default: 1)
`close`	`<tab-id>`	Tab ID (positional, required)
`close`	`--final-amount <amount>`	Final settlement amount in USDC
`close`	`--provider-sig <hex>`	Provider's EIP-712 TabCharge signature (from `signTabCharge`)

`fund` Flags

Flag	Description
`--amount <usdc>`	Pre-fill amount on the fund page
`--name <name>`	Agent or person name shown on the fund page
`--message <msg>`	Message shown on the fund page (repeatable)

`update` Flags

Flag	Description
`--check`	Check for updates without installing. Exit 0 if up-to-date, exit 1 if outdated.
`-y`, `--yes`	Skip interactive confirmation prompt

If the CLI detects it was installed via a package manager (Homebrew, Scoop, cargo, npm, snap), it prints the appropriate update command instead of self-updating.

Auth

CLI signer (default, recommended)

remit signer init                     # one-time setup — generates encrypted keystore
export REMIT_SIGNER_KEY=your-password

Keys are AES-256-GCM encrypted at ~/.remit/keys/default.enc. The CLI decrypts in-process when signing. SDKs invoke remit sign as a subprocess — no HTTP server, no ports, no network exposure.

OWS

remit init --ows                      # one-time setup
export OWS_WALLET_ID=remit-my-agent   # wallet name from init
export OWS_API_KEY=<token>            # shown once by init

Keys live in ~/.ows/wallets/ (AES-256-GCM encrypted). Never appear in env vars.

Raw key (legacy)

export REMITMD_KEY=0x<your-private-key>

Or remit init --legacy --write-env to generate and save to .env.

Never commit private keys to git.

Shell Completions

remit completions bash >> ~/.bash_completion           # bash
remit completions zsh > "${fpath[1]}/_remit"           # zsh
remit completions fish > ~/.config/fish/completions/remit.fish  # fish
remit completions powershell >> $PROFILE               # PowerShell

JSON Output

All commands support --json for scripting:

remit --json balance | jq '.usdc'
remit --json status | jq '.monthly_volume'
remit --json webhook list | jq '.[].url'

License

MIT

remit-cli 0.5.5