GRID CLI

GRID 0.2.18 is the primary operator surface: join the P2P fabric, mine verified work, host computes, inspect resources, manage wallets, and talk to the public registry.

Install

bash

# Official signed installer
curl -fsSL https://grid-compute.com/downloads/install.sh | bash

grid --version
grid --help

# Current expected release:
# grid 0.2.18

Initialize operator state

bash

# Choose one key-protection method
grid auth keyphrase
# or: grid auth passkey | password | combo

grid init --name garage --class S
grid status

State defaults to ~/.grid. Override it with --config-dir or GRID_CONFIG_DIR when running isolated test nodes.

Join P2P

bash

# Canonical Genesis is included automatically
grid peer --name garage --with-bench

# Optional explicit peer
grid peer --name garage --connect peer.example:9900

Mine and host

bash

# Mine-track Proof-of-Resource work
grid mine

# Host-track useful container work
grid host

# Run host + mine together
grid node
# alias:
grid start

# Coordinator and reward totals
grid stats

These commands default to https://coordinator.grid-compute.com. A node is credited only after the coordinator verifies its result and creates a settlement receipt.

grid node runs host + mine. It does not replace grid peer; keep the peer process running separately for encrypted gossip and block replication.

Resources and benchmark

bash

grid resources
grid bench --duration 3
grid bench --duration 3 --json
grid status

Wallet commands

bash

# Native GRID chain wallet
grid wallet init
grid wallet status
grid wallet receive
grid wallet claim
grid wallet history --limit 20

# Solana devnet reward wallet
grid solana create
grid solana status
grid solana import YOUR_EXISTING_ADDRESS

Talk to the registry

bash

# Pull public directory (uses https://grid-compute.com by default)
grid registry

# Override if needed
GRID_SITE_URL=https://grid-compute.com grid registry

Run an ember

After claiming a realm and activating its public registry name, start the full realm stack:

bash

grid ember fire --start

# Tracks typically include:
#   host   — useful work
#   mine   — verified PoR work
#   compute — named capacity (e.g. fire)
#   registry — announce + globe ping

Environment

~/.grid/env

GRID_COORDINATOR=https://coordinator.grid-compute.com
GRID_REGISTRY_URL=https://grid-compute.com
GRID_GENESIS=https://genesis.grid-compute.com
GRID_SITE_URL=https://grid-compute.com
GRID_GLOBE_LAT=37.7            # optional opt-in globe
GRID_GLOBE_LNG=-122.4
GRID_GLOBE_REGION=NA-W

Public globe heartbeats do not use a shared secret. The CLI creates a dedicated Ed25519 key under ~/.grid/keys and signs each pulse automatically.

Check the production gate

bash

grid mainnet
grid mainnet --json

This is intentionally fail-closed. A valid replicated chain is not enough: decentralized mainnet requires enforced quorum certificates, at least four independent validators, treasury consensus state, and an external audit.

Node config sketch

~/.grid/config.toml

[node]
name = "MacNode"
node_id = "node_macmini"
class = "S"
region = "NA-W"
globe_lat = 37.7
globe_lng = -122.4
globe_region = "NA-W"

Command map

grid status — local node health
grid mainnet — decentralized launch gate
grid registry — public directory
grid peer — P2P replication and peer gossip
grid mine — mine-track verified work
grid stats — coordinator and reward totals
grid ember <name> --start — full realm stack
grid auth login — operator identity (local vault)

Official binaries also appear on grid-compute.com download sections. Verify the signed manifest and SHA-256 checksum before running a download.