@ramp/cli
CLI for Ramp's Developer API. Authenticate with OAuth, manage expenses, approve bills, book travel, and more — from your terminal or AI agent.
Install
npm install -g @ramp/cli
Or run directly without a global install:
npx @ramp/cli --help
Requires Node.js 22+ and npm 10+ (Python is not required). Supported platforms: macOS (Apple Silicon & Intel), Linux (glibc x64 & arm64), and Windows (x64).
For one-command Ramp Router setup, see @ramp/router (npx @ramp/router).
Quick Start
ramp auth login # OAuth via browser
ramp users me # Current user details
ramp bills search --query "Acme" # Search bills by vendor name
ramp cards list # List your cards (card_state shows ACTIVE)
ramp transactions list --transactions_to_retrieve my_transactions
ramp transactions list --transactions_to_retrieve my_transactions --from_date 2025-01-01
ramp transactions list --transactions_to_retrieve my_transactions --rationale "Monthly review" --agent # JSON output for scripting
ramp router # Open the Router workspace
ramp update # Update to the latest release
Commands
| Command | Description |
|---|---|
auth | Login, logout, check status |
config | Get/set CLI configuration |
env | Show or set default environment (sandbox/production) |
profile | Show, list, or switch credential profiles |
router | Connect coding agents, manage keys and strategies |
applications | Apply for a Ramp account |
skills | Browse and install agent skill instructions |
update | Update the CLI to the latest release |
feedback | Submit feedback about the CLI |
Resources
12 resources, each with their own tools:
| Resource | Tools |
|---|---|
accounting | categories, category-options |
bills | search, get, draft, pending, approve, attachments |
cards | list, activate, lock (aliases also under funds) |
funds | list, activate, creds, lock |
general | comment, explain, help-center |
purchase-orders | search, get |
receipts | upload, attach |
reimbursements | list, pending, submit, approve, edit |
requests | pending, approve |
transactions | list, get, approve, edit, missing, flag-missing, explain-missing, memo-suggestions, trips |
travel | list, create, bookings, locations |
users | list, me, org-chart |
Usage: ramp <resource> <tool> [OPTIONS]
Global Flags
| Flag | Description |
|---|---|
--env, -e | production (default) or sandbox |
--output, -o | Output format: json or table |
--agent | Machine-readable JSON output (default when piped) |
--human | Human-readable table output (default in terminal) |
--wide | Show all columns in table output |
--quiet, -q | Suppress progress output |
--no-input | Disable interactive prompts (for CI/scripts) |
Tool Flags
| Flag | Description |
|---|---|
--json TEXT | Raw JSON request body (bypasses flags) |
--dry_run, -n | Print request without sending |
--page_size N | Results per page |
--next_page_cursor | Resume pagination from previous response |
Run ramp <resource> <tool> --help to see all available flags for a tool.
Agent Mode
--agent outputs JSON for scripting and AI agent consumption. Pipe to jq for processing:
ramp transactions list --transactions_to_retrieve my_transactions --rationale "Monthly review" --agent | jq '.data[0]'
ramp users me --rationale "Look up my user ID" --agent | jq '.data[0].user_id'
License
MIT — see https://github.com/ramp-public/ramp-cli for full documentation and source.