Caravo CLI

Command-line interface for Caravo — search, execute, and review marketplace tools with API key or x402 USDC payments.

Install

npm install -g @caravo/cli

Usage

# Search for tools
caravo search "image generation" --per-page 5

# Get tool details
caravo info fal-ai/flux/schnell

# Execute a tool
caravo exec fal-ai/flux/schnell -d '{"prompt": "a sunset over mountains"}'

# Preview cost without paying
caravo dry-run fal-ai/flux/schnell -d '{"prompt": "test"}'

# Submit a review
caravo review EXECUTION_ID --rating 5 --comment "Great quality"

# Upvote an existing review
caravo upvote REVIEW_ID --exec EXECUTION_ID

# Manage favorites (works with or without API key)
caravo fav list
caravo fav add fal-ai/flux/schnell
caravo fav rm fal-ai/flux/schnell

# Check wallet
caravo wallet

# Raw x402 HTTP
caravo fetch https://example.com/api
caravo fetch POST https://example.com/api -d '{"key": "value"}'

Payment

Payment is transparent — the same commands work in either mode:

• API key mode: Set CARAVO_API_KEY — balance is deducted per call
• x402 USDC mode: No API key needed. The CLI auto-manages a wallet and signs USDC payments on Base

Commands

Command	Description
search	Search tools by query, tag, or provider
info	Get tool details, pricing, and reviews
exec	Execute a tool
dry-run	Preview execution cost
review	Submit a review
upvote	Upvote an existing review
fav	Manage favorites (list, add, rm)
tags	List all categories
providers	List all providers
requests	List tool requests
request	Submit a tool request
request-upvote	Upvote a tool request
wallet	Show wallet address and USDC balance
fetch	Raw x402-protected HTTP requests

Development

npm install
npm run build
npm link      # makes `caravo` available globally

Ecosystem

• caravo.ai — Official website and marketplace
• Caravo-MCP — Official MCP server (@caravo/mcp)
• Agent-Skills — Agent skill via Caravo CLI — no MCP required

License

MIT