zz   
  ( -.-)  
   > ^ <

httpcat CLI 🐱

> command-line interface for token operations with ASCII cats

> cat makes tokens. cat trades tokens. cat does it all from your terminal.

// interactive shell with ASCII art cats • headless JSON mode • MCP server support

// automatic x402 payments • multi-network support • secure config storage

📦

Installation

npm (recommended)
$ npm install -g httpcat-cli
npx (no install)
$ npx httpcat-cli@latest
Homebrew (macOS/Linux)
$ brew tap hathbanger/httpcat
$ brew install httpcat
⚡

Quick Start

> 1. Run httpcat to start the setup wizard:

$ httpcat

> 2. Enter your private key, network, and preferences

// cat will remember your settings in ~/.config/httpcat

> 3. Start trading! Interactive shell opens automatically

// interactive shell with ASCII cats
httpcat> create "Moon Cat" "MOON"
httpcat> buy MOON 0.20
httpcat> list
🎨

Interactive Mode

> run httpcat without arguments to enter interactive shell

// beautiful REPL with ASCII art cats and colored output

// example interactive session
/\_/\ ( ^.^ ) Welcome to httpcat! > ^ < Your agent for token operations 🔗 Connected to: base-sepolia 🌐 Agent: https://agent.402.cat httpcat> create "Meow Token" "MEOW" /\_/\ ( o.o )💭 Creating your token... 💳 Payment required: $0.01 USDC ✅ Token created successfully! httpcat> buy MEOW 0.20 💰 Tokens purchased successfully! [🐱==> ] 0.15% to moon!
✓ASCII art cats for every action
✓Colored output and progress bars
✓Tab completion and history
✓Built-in help system
📋

Commands Reference

create
Create a new token on the bonding curve
Cost: $0.01 USDC
// usage
$ httpcat create "Moon Cat" "MOON"
// example
httpcat create "My Token" "MTK" --website https://mytoken.io
Options:
--photo <url>
--banner <url>
--website <url>
buy
Buy tokens from the bonding curve
Cost: Amount + 1% fee
// usage
$ httpcat buy <identifier> <amount>
// example
httpcat buy MOON 0.20
sell
Sell tokens back to the bonding curve
Cost: 1% fee deducted
// usage
$ httpcat sell <identifier> <amount|%|all>
// example
httpcat sell MOON 50%
info
Get detailed information about a token
Cost: $0.0001 USDC
// usage
$ httpcat info <identifier>
// example
httpcat info MOON
list
List all tokens with pagination and sorting
Cost: $0.0001 USDC
// usage
$ httpcat list [--sort mcap|created|name] [--limit N] [--page N]
// example
httpcat list --sort mcap --limit 10
Options:
--sort
--limit
--page
balance
Check wallet balance (ETH and USDC)
Cost: Free
// usage
$ httpcat balance
// example
httpcat balance
health
Check if the httpcat agent is running
Cost: $0.0001 USDC
// usage
$ httpcat health
// example
httpcat health
chat
Start streaming chat with the community
Cost: $0.01 to join, $0.0001 per message
// usage
$ httpcat chat [token]
// example
httpcat chat MOON
config
Manage configuration
Cost: Free
// usage
$ httpcat config [--show|--set|--reset]
// example
httpcat config --show
Options:
--show
--set
--reset
🤖

Headless Mode (JSON Output)

> perfect for scripting, automation, or LLM/agent integration

// add --json flag to any command for structured JSON output

// example: create token with JSON output
$ httpcat --json create "Test Token" "TEST"
{
  "success": true,
  "operation": "create_token",
  "data": {
    "tokenId": "abc123-...",
    "name": "Test Token",
    "symbol": "TEST",
    "status": "active"
  }
}
✓Structured JSON responses
✓Consistent error format
✓Exit codes for automation
✓Quiet mode (--quiet)
⚙️

Configuration

> config stored at ~/.config/httpcat/config.json

// private key, network, agent URL, preferences

> environment variables override config

$ export HTTPCAT_PRIVATE_KEY=0x...
$ export HTTPCAT_AGENT_URL=http://...

> command-line flag has highest priority

$ httpcat --private-key 0x... create "Token" "TKN"
✓Priority: CLI flag > env var > config
✓Multi-environment support
✓Secure local storage
✓Easy setup wizard
✨

Features

✓Interactive shell with ASCII art cats
✓Headless JSON mode for automation
✓Built-in MCP server support
✓Automatic x402 payment handling
✓Multi-network (testnet/mainnet)
✓Rich output with tables and progress
✓Secure config storage
✓TypeScript & optimized performance
🚀

Example Workflow

// complete workflow from setup to trading
# Setup
$ httpcat config

# Check balance
$ httpcat balance

# Create a token
$ httpcat create "Moon Cat" "MOON" --website https://mooncat.io

# Buy tokens
$ httpcat buy MOON 0.20

# Check your position
$ httpcat info MOON

# Sell half when profitable
$ httpcat sell MOON 50%

# List all tokens
$ httpcat list --sort mcap
httpcat CLI • version 0.0.10 • cat-approved token operations • GitHub