CLI

The galene binary has four commands. Run galene --help or galene <command> --help for the full list at any time.

galene start

Boot the local fork. This is the copy-on-read mainnet sandbox. It serves JSON-RPC. By default it also serves Galene Studio and a live terminal dashboard.

CLIgalene start [flags]

Flags

Flag	Default	Description
`--addr <addr>`	`127.0.0.1:9123`	Address the JSON-RPC server binds to. Use `0.0.0.0:9123` to expose it (e.g. in Docker). Also read from `GALENE_RPC_ADDR`.
`--grpc-addr <addr>`	`127.0.0.1:9000`	Address the Sui gRPC (`sui.rpc.v2`) server binds to, sharing the same fork state. Also read from `GALENE_GRPC_ADDR`. See gRPC.
`--no-grpc`	off	Disable the gRPC server (serve JSON-RPC only).
`--no-tui`	off	Disable the live dashboard and log plainly instead (for CI, Docker, or piped output).
`--epoch-secs <n>`	`10`	Seconds between automatic epoch advances in the live dashboard.
`--no-studio`	off	Don’t serve Galene Studio alongside the fork.
`--studio-port <port>`	`9124`	Port to serve Galene Studio on.
`--config <file>`	`./galene.toml`	Config file to load. See Configuration.
`--scenario <file>`	from `galene.toml`	Declarative scenario file (TOML) applied on boot: clock, epoch, sender, mints, objects, packages.
`--load-state <file>`	—	Reload a fork dumped earlier with `galene_dumpState` (a JSON file) before serving.

galene replay

Replay a mainnet transaction locally and capture its trace into .galene/replays/<digest>/.

CLIgalene replay <tx-digest> [flags]

Arguments and flags

Argument / Flag	Default	Description
`<digest>`	—	Transaction digest to replay.
`--network <env>`	`galene.toml`’s `fork.network`	Sui client env alias to source mainnet state from.
`--config <file>`	`./galene.toml`	Config file to load.

galene graph

Replay a transaction and print its per-command object graph (Proteus).

CLIgalene graph <tx-digest> [flags]

Arguments and flags

Argument / Flag	Default	Description
`<digest>`	—	Transaction digest to replay and graph.
`--network <env>`	`galene.toml`’s `fork.network`	Sui client env alias to source mainnet state from.
`--config <file>`	`./galene.toml`	Config file to load.

galene studio

Launch Galene Studio (the local web dashboard) from the embedded build. Useful when you want the UI without galene start.

CLIgalene studio [flags]

Flags

Flag	Default	Description
`--port <port>`	`9124`	Port to serve Studio on.
`--no-open`	off	Don’t auto-open the browser.