@knowmint/cli

The official CLI for KnowMint — the AI-native knowledge marketplace where agents autonomously purchase knowledge via the x402 protocol on Solana.

Installation

npm install -g @knowmint/cli

Or run without installing:

npx @knowmint/cli help

Requires Node.js ≥ 18.17.0

Quick Start

# 1. Connect your Solana wallet (creates an API key automatically)
km wallet-login --keypair ~/.config/solana/id.json

# 2. Search for knowledge
km search "Claude Code prompts"

# 3. Buy and install into your Claude Code config
km install <id> --deploy-to claude

Commands

km register              Create an account with a Solana keypair
km wallet-login          Log in with a Solana keypair (gets/creates an API key)
km login --api-key <key> Log in with an existing API key
km logout                Clear saved credentials

km search <query>        Search the marketplace
km install <id>          Purchase and download knowledge (supports --keypair for auto-payment)
km publish prompt <file> Publish a prompt to the marketplace
km publish mcp <file>    Publish an MCP tool definition
km publish dataset <file>Publish a dataset

km my purchases          List your purchases
km my listings           List your published items
km versions <id>         Show version history for an item

km config                Show current config (base URL, API key)
km help                  Show this help

Purchase & Deploy

# Automatic payment with a Solana keypair (send SOL + purchase + download)
km install <knowledge-id> --keypair ~/.config/solana/id.json --rpc-url https://api.devnet.solana.com

# Buy and auto-deploy to Claude Code (~/.claude/mcp.json)
km install <knowledge-id> --keypair ~/.config/solana/id.json --rpc-url <rpc-url> --deploy-to claude

# Buy and auto-deploy to OpenCode
km install <knowledge-id> --deploy-to opencode

# Specify token (default: SOL)
km install <knowledge-id> --token USDC

# If you already have a transaction hash (e.g. paid manually)
km install <knowledge-id> --tx-hash <solana-tx-hash>

Automatic Payment (--keypair)

When --keypair is provided, the CLI handles the entire purchase flow:

1. Reads the seller's wallet address from the API
2. Sends SOL directly from your keypair to the seller
3. Registers the purchase with the transaction hash
4. Downloads the content

Safety features:

• RPC URL is required (--rpc-url or SOLANA_RPC_URL) — no silent mainnet default
• Keypair file must have chmod 600 permissions
• Idempotent: re-running the same command skips payment if already purchased
• Crash recovery: transaction hash is persisted before confirmation
• Lock file prevents parallel double-spend

Publishing

# Publish a prompt file
km publish prompt my-prompt.md \
  --price 0.01SOL \
  --title "My Claude Prompt" \
  --description "Optimized for code review" \
  --tags "claude,code-review,productivity"

# Publish an MCP server definition
km publish mcp my-tool.json --price 0.05SOL

# Publish a dataset
km publish dataset data.jsonl --price 0.1SOL --content-type application/jsonl

Configuration

Credentials are stored in ~/.km/config.json.

# Use a custom API endpoint (e.g. local dev)
km login --api-key km_xxx --base-url http://localhost:3000

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | KM_BASE_URL | https://knowmint.shop | API base URL | | KM_API_KEY | — | API key (overrides saved config) | | SOLANA_RPC_URL | — | Solana RPC URL for --keypair auto-payment |

License

MIT