CLI reference

Full command reference for the SadClaw CLI.

Install

Run without installing:

npx sadclaw

Install globally:

npm install -g sadclaw
sadclaw --help

If you hit weird caching issues, force latest:

npx sadclaw@latest

Commands

Setup & configuration

sadclaw init

Initialize SadClaw configuration and wallet.

npx sadclaw init

Options:

Option	Description
--new	Create a new wallet
--import	Import existing wallet
--network <network>	Network: mainnet or devnet (default: mainnet)

Example:

# Create new wallet
npx sadclaw init --new

# Import existing wallet
npx sadclaw init --import

sadclaw config

View or update configuration.

npx sadclaw config

Options:

Option	Description
--set <key> <value>	Set a config value
--get <key>	Get a config value
--list	List all config

Example:

# View all config
npx sadclaw config --list

# Set RPC URL
npx sadclaw config --set rpcUrl https://api.mainnet-beta.solana.com

Wallet

sadclaw balance

Check wallet balance.

npx sadclaw balance

Output:

🦀 Wallet Balance
━━━━━━━━━━━━━━━━━━━━━━

Address: 7xKX...abc123

SOL:  0.05 (~$10.00)
USDC: 25.00

sadclaw address

Display wallet address.

npx sadclaw address

VM Management

sadclaw buy

Purchase a new VM.

npx sadclaw buy --tier <tier> --duration <hours>

Options:

Option	Description	Default
-t, --tier <tier>	VM tier: MICRO, SMALL, STANDARD, LARGE, XLARGE	Required
-d, --duration <hours>	Duration in hours (1-720)	24
-r, --region <region>	Region: fsn1, nbg1, hel1	fsn1
--dry-run	Show cost without purchasing	false

Examples:

# Standard tier for 24 hours
npx sadclaw buy --tier STANDARD --duration 24

# Micro tier in Helsinki for 1 hour
npx sadclaw buy -t MICRO -d 1 -r hel1

# Check cost without buying
npx sadclaw buy --tier LARGE --duration 48 --dry-run

Output:

🦀 Purchasing VM...

Tier: STANDARD
Duration: 24 hours
Cost: 2.40 USDC
Region: fsn1

✓ Transaction confirmed: 5abc...xyz
✓ NFT minted: 9abc...xyz789
✓ VM provisioning...
✓ VM ready!

NFT Mint: 9abc...xyz789
IP Address: 123.45.67.89
SSH User: root
Expires: 2026-02-04 12:00:00 UTC

sadclaw list

List your VMs.

npx sadclaw list

Options:

Option	Description
--all	Include expired VMs
--json	Output as JSON

Output:

🦀 Your VMs
━━━━━━━━━━━━━━━━━━━━━━

NFT: 9abc...xyz789
  Tier: STANDARD
  IP: 123.45.67.89
  Status: active
  Expires: 2026-02-04 12:00:00 UTC

NFT: 7def...uvw456
  Tier: MICRO
  IP: 98.76.54.32
  Status: active
  Expires: 2026-02-03 18:00:00 UTC

Total: 2 active VMs

sadclaw ssh

SSH into a VM.

npx sadclaw ssh <nft-mint>

Arguments:

Argument	Description
<nft-mint>	The NFT mint address of the VM

Example:

npx sadclaw ssh 9abc...xyz789

This opens an interactive SSH session to the VM.

sadclaw extend

Extend a VM's duration.

npx sadclaw extend <nft-mint> --duration <hours>

Arguments:

Argument	Description
<nft-mint>	The NFT mint address of the VM

Options:

Option	Description	Default
-d, --duration <hours>	Additional hours	24

Example:

# Add 24 hours
npx sadclaw extend 9abc...xyz789 --duration 24

sadclaw destroy

Destroy a VM (burns the NFT).

npx sadclaw destroy <nft-mint>

Arguments:

Argument	Description
<nft-mint>	The NFT mint address of the VM

Options:

Option	Description
--force	Skip confirmation prompt

Example:

npx sadclaw destroy 9abc...xyz789

This is irreversible. The VM and all its data will be permanently deleted.

sadclaw transfer

Transfer a VM to another wallet.

npx sadclaw transfer <nft-mint> <recipient>

Arguments:

Argument	Description
<nft-mint>	The NFT mint address of the VM
<recipient>	Recipient wallet address

Example:

npx sadclaw transfer 9abc...xyz789 8xyz...recipient

Information

sadclaw tiers

List available VM tiers.

npx sadclaw tiers

Output:

🦀 VM Tiers
━━━━━━━━━━━━━━━━━━━━━━

MICRO    $0.04/hr  1-2 vCPUs   1-4 GB RAM
SMALL    $0.06/hr  2-4 vCPUs   4-8 GB RAM
STANDARD $0.10/hr  4-8 vCPUs   8-16 GB RAM
LARGE    $0.20/hr  8-16 vCPUs  16-32 GB RAM
XLARGE   $0.40/hr  16-32 vCPUs 32-64 GB RAM

sadclaw status

Check SadClaw service status.

npx sadclaw status

Environment Variables

Variable	Description
SADCLAW_WALLET	Path to wallet keypair file
SADCLAW_RPC_URL	Solana RPC URL
SADCLAW_NETWORK	Network: mainnet or devnet

Configuration File

Config is stored at ~/.sadclaw/config.json:

{
  "wallet": "~/.sadclaw/wallet.json",
  "rpcUrl": "https://api.mainnet-beta.solana.com",
  "network": "mainnet",
  "apiUrl": "https://api.sadclaw.cloud"
}