remit-cli-0.4.0 is not a library.

remit-cli

Skill MD · Docs · Agent Spec

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

Install

Binary (recommended)

# Linux (x86_64)
curl -L https://github.com/remit-md/remit-cli/releases/latest/download/remit-linux-x86_64 -o remit
chmod +x remit && sudo mv remit /usr/local/bin/

# Linux (aarch64)
curl -L https://github.com/remit-md/remit-cli/releases/latest/download/remit-linux-aarch64 -o remit
chmod +x remit && sudo mv remit /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://github.com/remit-md/remit-cli/releases/latest/download/remit-macos-aarch64 -o remit
chmod +x remit && sudo mv remit /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/remit-md/remit-cli/releases/latest/download/remit-macos-x86_64 -o remit
chmod +x remit && sudo mv remit /usr/local/bin/

# Windows (PowerShell)
irm https://github.com/remit-md/remit-cli/releases/latest/download/remit-windows-x86_64.exe -OutFile remit.exe

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 local signer (default, recommended)

The local signer runs a lightweight HTTP signing server on localhost:7402. Private keys are AES-256-GCM encrypted at rest. Any SDK or language can sign via HTTP — no FFI, no native dependencies.

remit init                        # generates wallet + encrypted key + bearer token
remit signer start                # starts signing server on localhost:7402
export REMIT_SIGNER_URL=http://localhost:7402
export REMIT_SIGNER_TOKEN=<shown by init>

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 options
remit init --name my-agent --chain base-sepolia

# Add spending limits
remit wallet set-policy --max-tx 500 --daily-limit 5000

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	Local signer	`REMIT_SIGNER_URL`	HTTP signing server on localhost. Any language, any sandbox.
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 REMIT_SIGNER_URL is set, the CLI delegates all signing to the local signer server. 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 0xCounterparty 100    # Open a tab with 100 USDC limit
remit tab charge <tab-id> 5.00       # Charge 5 USDC to the tab
remit wallet fund                    # Open fund link in browser
remit --testnet mint 100             # Mint 100 testnet USDC

Commands

Command	Description
`remit init`	Create local signer wallet (default), OWS (`--ows`), or raw key (`--legacy`)
`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/charge/close`	Tab (running balance)
`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`	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 signer init`	Generate new wallet + encrypted key + bearer token
`remit signer start`	Start signing server on localhost:7402
`remit signer stop`	Stop the signing server
`remit signer status`	Check if signer is running
`remit signer import --key 0x...`	Import an existing private key
`remit signer token create`	Create a new bearer token
`remit signer token list`	List bearer tokens
`remit signer token revoke <name>`	Revoke a bearer token
`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 local signer
`--legacy`	Skip signer/OWS, generate a raw private key instead
`--write-env`	(Legacy only) Write key to `.env` in current directory

`wallet set-policy` Flags

Flag	Description
`--chain <CHAIN>`	`base` or `base-sepolia` (default: `base`)
`--max-tx <USDC>`	Per-transaction spending cap in dollars
`--daily-limit <USDC>`	Daily spending cap in dollars

`wallet fund` Flags

Flag	Description
`--wallet <NAME>`	Wallet name or ID (default: `OWS_WALLET_ID` env var)
`--amount <USDC>`	Pre-fill fund amount

`pay` Flags

Flag	Description
`--no-permit`	Skip EIP-2612 permit auto-signing (use existing on-chain approval instead)
`--memo <text>`	Attach a memo to the payment

Auth

Local signer (default, recommended)

remit init                            # one-time setup — generates wallet + token
remit signer start                    # start signing server
export REMIT_SIGNER_URL=http://localhost:7402
export REMIT_SIGNER_TOKEN=<token>     # shown once by init

Keys are AES-256-GCM encrypted at ~/.remit/keys/. The signer exposes POST /sign and POST /sign-typed-data over localhost HTTP. Any SDK or language can use it — no FFI required.

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.4.0