Installation

Installation Methods

httpcat-cli can be installed in multiple ways depending on your preference and workflow.

npm (Recommended)

Install globally via npm for the best experience:

npm install -g httpcat-cli

After installation, the httpcat command will be available system-wide. Verify installation:

httpcat --version

npx (No Install Required)

Use npx to run httpcat without installing:

npx httpcat-cli@latest

This always uses the latest version but takes slightly longer to start since it downloads the package each time. Useful for:

Quick one-off commands
CI/CD pipelines
Trying before installing
Always using the latest version

Homebrew (macOS/Linux)

Install via Homebrew tap:

brew tap hathbanger/httpcat
brew install httpcat

Update to latest:

brew upgrade httpcat

System Requirements

Node.js: 18.0.0 or higher
Operating Systems: macOS, Linux, Windows (via WSL recommended)
Network: Base Sepolia or Base mainnet access

Configuration

After installation, run the setup wizard:

httpcat config

This will guide you through:

Wallet Setup: Import or generate a private key
Network Selection: Base Sepolia (testnet) or Base (mainnet)
Preferences: ASCII art, color output, etc.

Configuration is stored at: ~/.config/httpcat/config.json

Never commit your config.json file to version control. It contains your encrypted private key.

Verification

Test your installation:

# Check if the agent is reachable
httpcat health

# Check your wallet balance
httpcat balance

# View help
httpcat --help

Upgrading

npm
Homebrew
npx

npm update -g httpcat-cli

brew upgrade httpcat

Uninstallation

npm
Homebrew

npm uninstall -g httpcat-cli

brew uninstall httpcat
brew untap hathbanger/httpcat

To remove configuration:

rm -rf ~/.config/httpcat

Troubleshooting

Command not found after npm install

Make sure npm’s global bin directory is in your PATH:

npm config get prefix

Add $(npm config get prefix)/bin to your PATH in ~/.bashrc or ~/.zshrc:

export PATH="$(npm config get prefix)/bin:$PATH"

Permission errors on npm install

Use one of these solutions:Option 1: Use npx instead (no permission issues)Option 2: Fix npm permissions:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Then retry the installation.

Network connection errors

If you see connection errors:

Check your internet connection
Verify you can reach the agent:
curl https://agent.402.cat/health
Check if you’re behind a proxy/firewall

Try setting a custom agent URL:

export HTTPCAT_AGENT_URL=https://agent.402.cat

Node.js version issues

httpcat-cli requires Node.js 18 or higher.Check your version:

node --version

Upgrade Node.js:

nvm: nvm install 18 && nvm use 18
Homebrew: brew upgrade node
Download: nodejs.org

Next Steps

Commands Reference

Learn all available commands

Configuration

Advanced configuration options

Quick Start

Get trading in 5 minutes

MCP Server

Use with AI assistants

Getting Started

httpcat-cli

MCP Server

Core Concepts

Installation Methods

npm (Recommended)

npx (No Install Required)

Homebrew (macOS/Linux)

System Requirements

Configuration

Verification

Upgrading

Uninstallation

Troubleshooting

Next Steps

Commands Reference

Configuration

Quick Start

MCP Server

​Installation Methods

​npm (Recommended)

​npx (No Install Required)

​Homebrew (macOS/Linux)

​System Requirements

​Configuration

​Verification

​Upgrading

​Uninstallation

​Troubleshooting

​Next Steps

Commands Reference

Configuration

Quick Start

MCP Server

Installation Methods

npm (Recommended)

npx (No Install Required)

Homebrew (macOS/Linux)

System Requirements

Configuration

Verification

Upgrading

Uninstallation

Troubleshooting

Next Steps