✓ Verified 💻 Development ✓ Enhanced Data

Crunch Coordinate

Use when managing Crunch coordinators, competitions (crunches), rewards, checkpoints, staking, or cr

Rating
4.3 (220 reviews)
Downloads
35,964 downloads
Version
1.0.0

Overview

Use when managing Crunch coordinators, competitions (crunches), rewards, checkpoints, staking, or cruncher accounts.

Complete Documentation

View Source →

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

PackageSourcePurpose
@crunchdao/crunch-clinpmCrunchDAO 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

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

Profiles

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

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

FlagDescription
-n, --networkSolana network: mainnet-beta, devnet, localhost
-u, --urlCustom RPC URL
-w, --walletPath to Solana keypair
-o, --outputOutput format: json, table, yaml

Direct Phrase Mapping

User PhraseCLI Command
get/show crunch crunch-cli crunch get ""
list crunchescrunch-cli crunch list
get/show coordinator [address]crunch-cli coordinator get [address]
list coordinatorscrunch-cli coordinator list
get configcrunch-cli coordinator get-config
checkpoint for crunch-cli crunch checkpoint-get-current ""
create checkpoint crunch-cli crunch checkpoint-create "" prizes.json
deposit reward crunch-cli crunch deposit-reward ""
drain crunch-cli crunch drain ""
create/register crunchercrunch-cli cruncher create
register for crunch-cli cruncher register ""
claim rewards crunch-cli cruncher claim ""
show staking positionscrunch-cli staking positions
stake/deposit crunch-cli staking deposit
delegate to crunch-cli staking delegate ""
show staking rewardscrunch-cli staking rewards
claim staking rewardscrunch-cli staking claim
undelegate from crunch-cli staking undelegate ""
withdraw stake crunch-cli staking withdraw
init workspace crunch-cli init-workspace ""
list scenarios/simulationscrunch-cli model list
run simulation crunch-cli model run ""
register coordinator crunch-cli coordinator register ""
create crunch crunch-cli crunch create "" [maxModels]
start/end crunch crunch-cli crunch start/end ""

Execution Pattern

  • Parse — Identify action, target, name/identifier, parameters
  • Resolve profile — If mentioned, switch profile or use flags
  • Map — Use phrase mapping table
  • Execute — Run command
  • 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:

bash
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

Installation

Terminal bash

openclaw install crunch-coordinate
    
Copied!

💻Code Examples

crunch-cli --version

crunch-cli---version.txt
## Profiles

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

crunch-cli config set <key> <value> # Set config value

crunch-cli-config-set-key-value--set-config-value.txt
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:
example.sh
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

Tags

#health_and-fitness

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author philippwassibauer
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install crunch-coordinate