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