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.createGlobal flags
These flags are available on every command.
--params: Raw JSON parameters for agent-driven execution--output,-o:pretty(default),json, orndjson--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 documentndjson: One JSON object per line
Use --quiet to suppress output if you only need the exit status.
Quick start
Explore command groups: