CLI Reference

The CLI is exposed as geppetto-cli. Inside this repository, use bun ./bin/geppetto-cli.ts.

init

geppetto-cli init
geppetto-cli init --dry-run

Generates canonical agent-entry files without overwriting existing files.

new

geppetto-cli new my-program

Creates a minimal Pinocchio + Geppetto scaffold.

test

geppetto-cli test
geppetto-cli test --skip-examples
geppetto-cli test --skip-build-sbf

Runs root checks and escrow example validation. Missing SBF artifacts are auto-built unless skipped.

audit

geppetto-cli audit
geppetto-cli audit --strict
geppetto-cli audit --locked

Runs the static audit gate.

deploy

geppetto-cli deploy --output json --write-back
geppetto-cli deploy --set solana.cluster=devnet

Runs the configured Solana and optional off-chain deployment workflow.