ramp-cli

Books flights conversationally through the ramp CLI: resolves cities to airports, searches one-way and round-trip flights, presents and compares offers, previews the fare, and tickets the booking on the traveler's explicit approval. The user describes a trip in plain language ('book a flight from Toronto to SFO') and never needs to know a CLI command. Use when someone wants to book, find, search, or compare flights, or says 'fly from X to Y'. Not for cancellations, changes, refunds, seat selection, loyalty programs, hotels, cars, or multi-city trips.

Search, inspect, track, and safely approve submitted procurement requests and purchase orders. Use when: 'find a PO', 'show procurement request details', 'purchase order status', 'what procurement requests need approval', or 'approve this PO request'. Do NOT use to create, continue, edit, review before submission, or submit a draft request (use submit-procurement-request), or for a cross-product approval queue (use approval-dashboard).

Create, complete, and submit new, existing draft, or approved-PO change-request Ramp procurement requests. Use when: 'submit a procurement request', 'start a purchase request', 'continue my draft', 'request to buy', 'create a PO request', 'change an approved PO', or 'submit a software purchase'. Do NOT use to track or approve a submitted request (use manage-procurement), or for reimbursements, bills, card expenses, vendor onboarding documents, or contract changes not tied to an approved Ramp PO.

Pay an x402 (HTTP 402) payment challenge from a merchant using the business's Ramp agentic Solana USDC wallet, then attach the payment and get the resource. Use when asked to pay for an x402 API/resource, 'pay with x402', buy an Exa search, create an AgentMail inbox, pay a paid API that returns 402, or complete/test an x402 payment. Requires the ramp CLI authenticated with the x402:write scope and a provisioned agentic Solana wallet.

Start or complete a Ramp financing application. Use for application signup, missing information, documents, banking, follow-ups, progress checks, and clear handoffs between an agent and the person applying.

Resolve the COMPLETE_INCORPORATION blocker in a Ramp financing application by filing a US LLC through Ramp. Use when GET /developer/v1/applications/progress returns user_action: COMPLETE_INCORPORATION with provider: doola. Also use after a submitted unformed-entity Ramp application reaches IN_REVIEW / WAIT_FOR_RAMP and the applicant explicitly asks to file the LLC. Also use for: "incorporate my business", "file an LLC for me", "set up an LLC through Ramp", "Ramp incorporation", "I don't have a legal entity yet". Do NOT use for: businesses that already have an EIN (use apply-to-ramp PATCH instead), non-US founders or country fields, companies without a US principal place of business, or C-Corp formation (Phase 1 is LLC-only).

Make purchases using Ramp agent cards via browser checkout, then complete all transaction requirements (memo, tracking categories, receipt, trip). Use when asked to buy something with an agent card, make a payment using Ramp, spend from a fund, complete missing transaction items, or test the agent card payment flow. Also use when asked about agent card access, availability, or how to get started with Agentic Cards. Requires ramp CLI and browser-automation skill.

Review and approve pending transactions, bills, reimbursements, and requests. Use when: 'approve', 'pending approvals', 'what needs my approval', 'review transactions', 'approve bills', 'reject', 'approval queue', 'clear my approvals'. Do NOT use for: transaction analysis, receipt uploads, or spend tracking.

Inspect a user's card/fund status, then activate or lock/unlock a card from the terminal. Use for card status, card lock questions, physical card activation, and card lock/unlock actions.

Hand your agent this playbook. It gets you set up on Ramp — or applying, if you're new — plus the menu of everything else you can do. Use as the one-fetch entry point for Ramp across Claude Desktop, ChatGPT, Claude Code, Codex, and Perplexity.

Search, inspect, and manage vendor bills and invoices. Use when: 'find a bill', 'show me pending bills', 'bill details', 'look up a bill', 'draft bill details', 'bill attachments', 'what bills need my approval'. Do NOT use for: approving bills (use approval-dashboard), uploading vendor documents (use vendor-document-upload), or card transaction management (use transaction-cleanup).

Look up vendor bill payments and verify payment status from the terminal. Use when: 'did we pay', 'payment status', 'check if paid', 'verify payment', 'find invoice', 'bill lookup', 'was this bill paid', 'payment confirmation'. Do NOT use for: approving bills (use approval-dashboard), spend analysis across vendors (use spend-analysis), or uploading receipts (use receipt-compliance).

Find your transactions missing receipts and upload them. Use when: 'missing receipts', 'receipt compliance', 'upload receipt', 'attach receipt', 'receipt sweep', 'transactions without receipts'. Do NOT use for memo/coding/fund cleanup (use transaction-cleanup) or approving transactions (use approval-dashboard).

Analyze spend by vendor, category, or team over a date range. Pulls card transactions and bill payments, aggregates totals, and produces summary tables. Use when: 'how much did we spend on', 'vendor spend', 'SaaS review', 'spend report', 'inference costs', 'total spend', 'spend by vendor', 'spend analysis', 'pull transactions for', 'cost breakdown'. Do NOT use for: approving transactions (use approval-dashboard), uploading receipts (use receipt-compliance), or verifying a single bill payment (use payment-lookup).

Submit an out-of-pocket reimbursement from a receipt. Use when: 'submit reimbursement', 'reimburse me', 'I paid out of pocket', 'expense a receipt', 'file reimbursement', 'OOP expense', 'I bought something for work'. Do NOT use for: approving reimbursements (use approval-dashboard), uploading receipts to card transactions (use receipt-compliance), or editing existing reimbursements.

Complete missing items on your transactions — memos, accounting categories, funds, and attendees. Use when: 'add memo', 'categorize transactions', 'missing items', 'transaction cleanup', 'fix my transactions', 'set tracking category', 'assign to fund', 'bulk memo update'. Do NOT use for: receipt uploads (use receipt-compliance) or approvals (use approval-dashboard).

Upload vendor documents such as W-9/W-8 tax forms, contracts, COIs, payment instructions, and onboarding paperwork, then check bulk upload OCR and matching status. Use when: 'upload a W9', 'attach a vendor contract', 'bulk upload supplier docs', 'check vendor document status', 'upload a COI for a vendor'. Do NOT use for card transaction receipts (use receipt-compliance) or bill invoice attachments (use bills commands).

Automate Google Chrome for web tasks — navigate sites, fill forms, click elements, take snapshots, and extract content. Powered by playwright-cli (pw) with a persistent browser profile. Use when asked to interact with a website, fill out a checkout form, scrape content, or perform any browser-based workflow.