Skip to content
Calimero Calimero Docs

meroctl CLI Reference

meroctl is the command-line client for Calimero nodes. Use it to install applications, create and manage contexts, call application methods, and work with blobs. This page covers the handful of commands you’ll use most; for the exhaustive command reference see the Core operate docs.

Install

Section titled “Install”
Terminal window
brew install calimero-network/tap/meroctl

Connecting to a node

Section titled “Connecting to a node”

Target a node by alias (configured in ~/.calimero/config.toml) or by direct URL:

Terminal window
meroctl --node node1 <command>
meroctl --api http://localhost:2528 <command>

Most-common commands

Section titled “Most-common commands”

Install an app — this returns an application id (it does not take one):

Terminal window
meroctl --node node1 app install --path res/my_app.wasm

Create a context for an installed app:

Terminal window
meroctl --node node1 context create --application-id <APP_ID>

List contexts:

Terminal window
meroctl --node node1 context ls

Call a method — the method name is positional; --context and --args follow, and --as optionally selects the executor public key:

Terminal window
# mutation
meroctl --node node1 call set --context <CTX> --args '{"key":"hello","value":"world"}'


# view (read-only)
meroctl --node node1 call get --context <CTX> --args '{"key":"hello"}'


# call as a specific identity
meroctl --node node1 call set --context <CTX> --args '{...}' --as <PUBLIC_KEY>

Work with blobs:

Terminal window
meroctl --node node1 blob ls
meroctl --node node1 blob upload --file demo.png --context-id <CTX>
meroctl --node node1 blob download --blob-id <BLOB_ID> --output demo.png

Health checks are not a meroctl command. Use merobox health or GET /admin-api/health on the node.

Full reference

Section titled “Full reference”

The complete command set — application packages, context aliases and sync, namespaces and groups for multi-node participation, peers, output formats (--output-format json), and every flag — is documented at:

Section titled “Related topics”