🔥 fuego-cli

Why Fuego?

The first Solana wallet CLI designed FOR autonomous agents.

• ⚡ Zero friction — No prompts, no waiting, just instant signing
• 🤖 Agent-first — Built for automated workflows
• 🏠 Local-only — Keys never leave your machine
• 🔄 Auto-updating — Stay current with fuego update

Installation

npm install -g fuego-cli

Quick Start

# 1. Create a wallet
fuego create

# 2. Install the Fuego server & tools
fuego install

# 3. Start the server
fuego serve

# 4. Check your balance
fuego balance

# 5. Open the dashboard
fuego dashboard

Commands

Wallet Management

| Command | Description | |---------|-------------| | fuego create | Create a new Solana wallet | | fuego address | Show your wallet address | | fuego balance | Check all token balances (SOL + SPL tokens) | | fuego rpc | Show or configure your Solana RPC endpoint | | fuego contacts | Manage your contacts | | fuego fund | Show funding options: MoonPay link + QR code | | fuego send | Send SOL, USDC, or USDT to an address or contact | | fuego jupiter quote | Get swap quotes from Jupiter | | fuego jupiter swap | Execute token swaps via Jupiter | | fuego purch | Purchase products via x402 (Amazon, Shopify, etc.) |

Project Management

| Command | Description | |---------|-------------| | fuego install | Install the Fuego server & tools | | fuego serve | Start the Rust server (cargo run) | | fuego dashboard | Open the HTML dashboard | | fuego update | Update CLI and/or Fuego project |

Detailed Usage

fuego create [options]

Create a new Fuego wallet with zero passwords.

fuego create --name prod-wallet

Options:

• -f, --force — Overwrite existing wallet
• -n, --name <name> — Wallet name (default: "default")

Creates:

~/.fuego/
├── wallet.json          # Private key (600 permissions)
├── wallet-config.json   # Public key + metadata
├── config.json          # CLI config with versions
└── contacts/
    └── address-book.json  # Your saved contacts

fuego balance

Check all token balances via the Fuego server. Shows SOL plus all SPL tokens in your wallet.

fuego balance
# or
fuego bal

Output:

💰 Your Balances

Address: DmFy...eUZF

- SOL:     0.105113976
- USDC:   28.85
- BONK:    712,687.68

fuego serve

Start the Fuego Rust server.

fuego serve

Auto-detects installation at:

• ~/.openclaw/workspace/fuego (OpenClaw agents)
• ./fuego (local installs)

fuego dashboard

Open the dashboard in your default browser.

fuego dashboard
# or
fuego dash

fuego update [options]

Update everything with one command.

# Update both
fuego update

# Update only CLI
fuego update --cli

# Update only Fuego project
fuego update --fuego

Tracks versions in ~/.fuego/config.json:

{
  "fuego-cli": {
    "version": "0.1.0",
    "lastUpdated": "2026-02-24T18:30:00.000Z"
  },
  "fuego": {
    "version": "a1b2c3d",
    "lastUpdated": "2026-02-24T18:35:00.000Z"
  }
}

fuego rpc [options]

Show or configure your Solana RPC endpoint for faster or more reliable connections.

# Show current RPC configuration
fuego rpc

# Set a custom RPC endpoint
fuego rpc --url https://helius.xyz/... --network mainnet

# Use public mainnet
fuego rpc --url https://api.mainnet-beta.solana.com

Options:

• -u, --url <url> — RPC endpoint URL
• -n, --network <network> — Network type: mainnet, devnet, testnet (default: mainnet)

fuego contacts <subcommand>

Manage your contacts for quick access to frequently used addresses.

# Add a contact
fuego contacts add melanie GvCoHGGBR97Yphzc6SrRycZyS31oUYBM8m9hLRtJT7r5 --label "Melanie's wallet"

# List all contacts
fuego contacts list

# Show specific contact
fuego contacts show melanie

# Remove contact (with confirmation)
fuego contacts remove melanie --yes

Storage: ~/.fuego/contacts/address-book.json

Commands:

• add <name> <address> [--label "description"] — Add a contact
• list — Show all contacts
• show <name> — Show contact details
• remove <name> [--yes] — Remove a contact

fuego fund

Show funding options for your wallet: MoonPay onramp link + QR codes for easy scanning.

fuego fund

Output:

• Your wallet address (plain text for copying)
• QR code of your address (scan to receive SOL from another wallet)
• MoonPay onramp URL (buy SOL with card/bank, pre-filled with your address)
• QR code for MoonPay link (scan to open on mobile)

Example:

💰 Fund Your Wallet
Address: DmFyLRiJtc4Bz75hjAqPaEJpDfRe4GEnRLPwc3EgeUZF

📱 Scan to receive SOL:

[QR CODE]

🔗 MoonPay Onramp
Buy SOL with card/bank and send directly to your wallet:

https://buy.moonpay.com/?currencyCode=SOL&walletAddress=DmFyLRiJtc4Bz75hjAqPaEJpDfRe4GEnRLPwc3EgeUZF

Or scan this QR code to fund:

[QR CODE]

Note: MoonPay requires KYC and is available in supported regions. The QR code for your address works with any Solana wallet (Phantom, Solflare, etc.).

fuego send <recipient> <amount>

Send SOL, USDC, or USDT to a Solana address or address book contact.

# Send SOL to an address
fuego send GvCoHGGBR97Yphzc6SrRycZyS31oUYBM8m9hLRtJT7r5 0.5 --token SOL

# Send USDC to a contact
fuego send melanie 10 --token USDC

# Send and confirm immediately
fuego send melanie 5 --token USDT --yes

Options:

• -t, --token <token> — Required. Token to send: SOL, USDC, or USDT
• -y, --yes — Skip confirmation prompt and send immediately

Recipient can be:

• A full Solana address (e.g., GvCoHGGBR97Yphzc6SrRycZyS31oUYBM8m9hLRtJT7r5)
• A contact name (e.g., melanie)

Safety: By default, fuego send shows a transaction preview and requires --yes to confirm. This prevents accidental sends.

fuego jupiter quote <amount>

Get a swap quote from Jupiter for any supported token pair.

# Quote SOL to USDC
fuego jupiter quote 0.5 --input SOL --output USDC

# Quote USDC to BONK
fuego jupiter quote 100 --input USDC --output BONK

# Quote using full mint addresses
fuego jupiter quote 1.0 --input SOL --output DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

Options:

• -i, --input <token> — Required. Input token symbol (SOL, USDC, USDT, BONK, JUP) or full mint address
• -o, --output <token> — Required. Output token symbol or full mint address

Output: Shows expected output amount, price impact, and routing information.

fuego jupiter swap <amount>

Execute a token swap via Jupiter.

# Swap SOL to USDC (preview only)
fuego jupiter swap 0.5 --input SOL --output USDC

# Swap SOL to BONK (with confirmation)
fuego jupiter swap 0.05 --input SOL --output BONK --yes

# Swap USDC to random token by mint address
fuego jupiter swap 10 --input USDC --output <mint-address> --yes

Options:

• -i, --input <token> — Required. Input token symbol or full mint address
• -o, --output <token> — Required. Output token symbol or full mint address
• -y, --yes — Skip confirmation and execute immediately

Supported Tokens: SOL, USDC, USDT, BONK, JUP (or any token by full mint address)

Note: For unknown tokens, provide the full 44-character mint address. The dashboard caches the top 100 tokens for symbol lookups.

fuego purch <product-url>

Purchase products via x402/Purch.xyz (Amazon) using USDC on Solana.

# Purchase from Amazon
fuego purch https://amazon.com/dp/B071G6PFDR \
  --email [email protected] \
  --name "John Doe" \
  --address-line1 "123 Main St" \
  --address-line2 "Apt 4B" \
  --city "Austin" \
  --state TX \
  --postal-code 78701 \
  --country US \
  --max-price 1000

Required Options:

• --email <email> — Email for order notifications
• --name <name> — Full name for shipping
• --address-line1 <address> — Street address line 1
• --city <city> — City
• --state <state> — State/Province code (e.g., TX)
• --postal-code <code> — Postal/ZIP code

Optional:

• --address-line2 <address> — Apartment, suite, etc.
• --country <code> — Country code (default: US)
• --max-price <cents> — Maximum price in cents (e.g., 1000 = $10.00). Required for URL-based products.

Important Notes:

⚠️ URL Format: Use the full Amazon URL, not abbreviated links (like a.co/...). Full URLs look like:

• ✅ https://www.amazon.com/dp/B0CJ44HMBF?th=1
• ❌ https://a.co/d/0ewxA3W7 (abbreviated links won't work)

⚠️ Max Price: For Amazon/Shopify products, --max-price is required. Enter the amount in cents:

• $5.00 → --max-price 500
• $10.00 → --max-price 1000
• $25.50 → --max-price 2550

How it works:

1. Sends product URL and shipping info to Purch.xyz
2. Receives x402 payment challenge ($0.01 USDC fee)
3. Builds and signs x402 payment transaction
4. Submits payment to Purch.xyz
5. Receives order transaction (ready for final submission)

Note: The final order transaction is displayed but not automatically submitted. Review the output to complete the purchase.

fuego install [options]

Install the Fuego project — Rust server, scripts, and dashboard. Automatically runs npm install after cloning.

Auto-detection:

1. Checks for ~/.openclaw/workspace first (OpenClaw agent machines)
2. If not found, creates ./fuego in your current directory

Note: This installs the Fuego server to ./fuego/ (or your custom path), not to ~/.fuego/. The ~/.fuego/ folder is only for your wallet files and CLI config.

# Auto-detect best location
fuego install

# Custom path
fuego install --path ~/projects/my-fuego

Architecture

┌─────────────────┐
│   fuego-cli     │  ← This package (wallet + commands)
│  (Node.js/npm)  │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   ~/.fuego/     │  ← Wallet storage
│   wallet.json   │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Fuego Server   │  ← Rust server (separate repo)
│  (cargo run)    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Solana Network │  ← mainnet/devnet
└─────────────────┘

Development

git clone https://github.com/willmcdeezy/fuego-cli.git
cd fuego-cli
npm install
npm run build
npm link  # Global testing

Security

• ✅ Private keys: chmod 600 (owner only)
• ✅ Local-first: No cloud, no hosted wallets
• ✅ Separate concerns: CLI vs server vs wallet

Related Projects

• 🔥 fuego — Rust server, Python scripts, dashboard

License

MIT © Will McDeezy