Introduction

Namera CLI gives agents controlled access to smart accounts with session keys and scoped permissions, running fully local and agent-first across chains.

Namera CLI gives agents controlled access to smart accounts with session keys and scoped permissions, running fully local and agent-first across chains. It is designed to let autonomous systems safely interact with wallets without exposing private keys or relying on centralized infrastructure.

What Namera CLI provides

  • Session Key based Access: Delegate wallet capabilities to agents using session keys instead of exposing primary private keys.
  • Scoped Permissions: Define exactly what an agent can do—limit contracts, methods, spending, and time windows.
  • Local-First Execution: Everything runs on-device with no required cloud dependency, ensuring privacy and reliability.
  • Agent-Controlled Workflows: Enable agents to execute transactions, automate flows, and interact with smart contracts autonomously.
  • Multichain Support: Operate across multiple chains seamlessly with a unified interface for signing and execution.
  • Programmable Permissions: Build complex permission logic with different types of policies.

Agent-first by design

Namera CLI is built around a simple idea: agents should be first-class users of wallets, not an afterthought. This means:

  • Every command has a JSON schema
  • Every command can be driven via --params
  • Prompts are the default, but never required
  • Outputs are consistent and machine-friendly

How it works

Each command supports two execution modes:

  • Interactive (default): missing inputs are prompted for
  • Params mode: provide JSON inputs using --params

Agents can discover the exact input shape using:

namera schema <command>

Example:

namera schema session-key.create

Global flags

These flags are available on every command.

  • --params: Raw JSON parameters for agent-driven execution
  • --output, -o: pretty (default), json, or ndjson
  • --quiet, -q: Suppress output entirely

Params mode

Use --params to bypass prompts and send a full JSON payload. This is the preferred mode for agents.

Example:

namera smart-account create --params '{"alias":"my-smart","ownerAlias":"my-owner","ownerPassword":"my-password","index":0}'

If --params is provided, the CLI ignores any interactive prompts and validates the payload against the schema.

Output formats

Most commands return structured data. Control the output format with --output:

  • pretty: Human-friendly output (default)
  • json: Single JSON document
  • ndjson: One JSON object per line

Use --quiet to suppress output if you only need the exit status.

Quick start

Explore command groups: