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):

Package	Source	Purpose
@crunchdao/crunch-cli	npm	CrunchDAO protocol CLI (coordinators, competitions, staking)

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:

Flag	Description
-n, --network	Solana network: mainnet-beta, devnet, localhost
-u, --url	Custom RPC URL
-w, --wallet	Path to Solana keypair
-o, --output	Output format: json, table, yaml

Direct Phrase Mapping

User Phrase	CLI Command
get/show crunch <name>	crunch-cli crunch get "<name>"
list crunches	crunch-cli crunch list
get/show coordinator [address]	crunch-cli coordinator get [address]
list coordinators	crunch-cli coordinator list
get config	crunch-cli coordinator get-config
checkpoint for <name>	crunch-cli crunch checkpoint-get-current "<name>"
create checkpoint <name>	crunch-cli crunch checkpoint-create "<name>" prizes.json
deposit reward <name> <amount>	crunch-cli crunch deposit-reward "<name>" <amount>
drain <name>	crunch-cli crunch drain "<name>"
create/register cruncher	crunch-cli cruncher create
register for <name>	crunch-cli cruncher register "<name>"
claim rewards <name>	crunch-cli cruncher claim "<name>"
show staking positions	crunch-cli staking positions
stake/deposit <amount>	crunch-cli staking deposit <amount>
delegate to <coordinator>	crunch-cli staking delegate "<coordinator>" <amount>
show staking rewards	crunch-cli staking rewards
claim staking rewards	crunch-cli staking claim
undelegate from <coordinator>	crunch-cli staking undelegate "<coordinator>" <amount>
withdraw stake <amount>	crunch-cli staking withdraw <amount>
init workspace <name>	crunch-cli init-workspace "<name>"
list scenarios/simulations	crunch-cli model list
run simulation <scenario>	crunch-cli model run "<scenario>"
register coordinator <name>	crunch-cli coordinator register "<name>"
create crunch <name>	crunch-cli crunch create "<name>" <amount> [maxModels]
start/end crunch <name>	crunch-cli crunch start/end "<name>"

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: <b>bold</b>, 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