CLI
Commands and resources
How to discover Ramp CLI commands, resources, flags, and agent-friendly output.
The CLI is organized into commands (setup and configuration) and
resources (Ramp objects with their own tools). The live CLI is the source of
truth, so run ramp --help and ramp <resource> --help when you need the exact
current list.
Commands
| Command | Description |
|---|---|
auth | Login, logout, check status |
config | Get / set CLI configuration |
env | Show or set the default environment (sandbox / production) |
applications | Apply for a Ramp account |
skills | Browse and install agent skill instructions |
feedback | Submit feedback about the CLI |
Resources
Usage: ramp <resource> <tool> [OPTIONS]
Common resource groups include:
| Resource | Tools |
|---|---|
accounting | Categories and coding helpers |
bills | Bill search, lookup, drafts, attachments, and eligible actions |
funds | Fund lookup and Agent Card-related fund operations |
general | Comments, explanations, Help Center, and policy helpers |
purchase_orders | search, get |
receipts | Receipt upload and attachment workflows |
reimbursements | Reimbursement lookup and eligible user actions |
requests | Request lookup and eligible actions |
transactions | Transaction lookup, missing items, memo suggestions, and eligible actions |
travel | Trips, bookings, and locations |
users | me, search, org-chart |
Exact tools can change as the CLI ships. Prefer ramp <resource> --help before
writing durable scripts.
Global flags
These work with any command:
| Flag | Behavior |
|---|---|
--env, -e | sandbox (default) or production |
--output, -o | Output format: json or table |
--quiet, -q | Suppress progress output |
--no-input | Disable interactive prompts (for CI / scripts) |
Per-tool flags
Common patterns available on individual tools:
| Flag | Behavior |
|---|---|
--json TEXT | Raw JSON request body (bypasses flags) |
--dry_run, -n | Print the request without sending it |
--page_size N | Results per page |
--next_page_cursor | Resume pagination from a previous response |
Example
List your own transactions with a smaller page size:
ramp transactions list --transactions_to_retrieve my_transactions --page_size 25For agent loops, combine structured output with non-interactive flags:
ramp transactions list --agent --no-input --quiet --env production