Crunch Protocol CLI Skill

Translates natural language queries into crunch-cli commands. Supports profiles and output formatting for Slack, Telegram, Discord, or plain text.

Prerequisites

• Node.js 18+ with npm
• Solana wallet keypair (for on-chain operations)

Package Installation

This skill installs packages via npm (global):

Agent rules for package installation:

• Only install @crunchdao/crunch-cli from the official npm registry
• No custom registry URLs — no --registry overrides
• Ask the user before installing if not already present

Credentials

Solana Wallet Keypair (required for on-chain operations)

• What it is: A JSON file containing a Solana private key, used to sign transactions
• How it's configured: Set via crunch-cli config set wallet /path/to/wallet.json or -w flag per command
• Stored in: User-managed file on disk; path referenced in ~/.crunch/config.json

Agent rules for wallets:

• Never create or generate wallet keypairs unless the user explicitly asks and understands the security implications
• Never read or display the contents of wallet keypair files
• Never commit wallet files to git — always verify .gitignore covers them
• Ask the user for the wallet path — never assume or search for keypair files

Profile Config (~/.crunch/config.json)

• Stores network, wallet path, and RPC URL per profile
• Managed via crunch-cli config commands — no need to edit manually
• Never modify or delete existing profiles unless explicitly asked

Setup

npm install -g @crunchdao/crunch-cli
crunch-cli --version

Profiles

The CLI has built-in profile management via ~/.crunch/config.json:

crunch-cli config show                    # Show current config
crunch-cli config active                  # Show resolved active values
crunch-cli config list-profiles           # List available profiles
crunch-cli config save-profile <name>     # Save current config as profile
crunch-cli config use <profile>           # Switch profile
crunch-cli config set <key> <value>       # Set config value

Global flags can override config per-command:

Direct Phrase Mapping

Execution Pattern

1. Parse — Identify action, target, name/identifier, parameters
2. Resolve profile — If mentioned, switch profile or use flags
3. Map — Use phrase mapping table
4. Execute — Run command
5. Format — Output for requested medium (Slack/Telegram/Discord/plain)

Output Formatting

Detect medium from user request ("for slack", "telegram format", etc.):

• Slack: bold, • bullets, ━ separators
• Telegram: bold, emoji prefixes
• Discord: ## headers, bold
• Plain: Simple key: value pairs

Error Handling

If command fails, suggest fixes:

• Wrong network? Add -n mainnet-beta or -n devnet
• Missing wallet? Add -w /path/to/wallet.json
• Not found? List available with crunch-cli crunch list

Coordinator Node Setup

Scaffold a new competition workspace:

crunch-cli init-workspace my-challenge

This generates a full node workspace. See the coordinator-node-starter skill for customization.

Reference

For full CLI documentation: references/cli-reference.md