# Output and Errors

> Documentation index: [llms.txt](https://namera.ai/llms.txt).

Source: https://namera.ai/docs/cli/output-and-errors

Read human summaries, parse JSON, and handle command failures.

## Human Output [#human-output]

```sh
namera wallet list
```

<div className="docs-response">

```text
Found 1 delegated wallet:

👛 Example account | Active
-> Address: 0x1111111111111111111111111111111111111111
-> Network type: EVM
-> Custody: Namera-managed
-> Description: SDK test account
-> Created: 11 Oct 2026, 09:00:00 UTC
```

</div>

Status and permissions use terminal colors when supported. `NO_COLOR` disables
colors; pipes and unsupported terminals use plain-text symbols.

## JSON Output [#json-output]

```sh
namera --output json wallet list
```

<div className="docs-response">

```json
[
  {
    "id": "0199dfe1-0000-7000-8000-000000000001",
    "organizationId": "0199dfe1-0000-7000-8000-000000000004",
    "metadata": {
      "version": 1,
      "name": "Example account",
      "logo": { "type": "emoji", "value": "👛" },
      "description": "SDK test account"
    },
    "status": "active",
    "namespace": "eip155",
    "address": "0x1111111111111111111111111111111111111111",
    "owner": {
      "signingKeyId": "0199dfe1-0000-7000-8000-000000000005",
      "custody": "namera-managed",
      "provider": "1claw",
      "algorithm": "secp256k1"
    },
    "createdAt": "2026-10-11T09:00:00.000Z",
    "updatedAt": "2026-10-11T09:00:00.000Z",
    "implementation": "alchemy-modular-v2",
    "data": {
      "version": 1,
      "modularAccountVersion": "2.0.0",
      "validatorType": "ecdsa_secp256k1",
      "entryPointVersion": "0.7",
      "accountMode": "7702",
      "delegationVersion": "v1.1.0"
    }
  }
]
```

</div>

The CLI prints one compact JSON value to stdout, not the SDK's
`{ success, data, error }` envelope. Successful list commands can return an
array or a paginated object. Bigint quantities are decimal strings.

## Quiet Mode [#quiet-mode]

```sh
namera --quiet auth status
```

Successful output is suppressed, but the command still runs and failures remain
visible on stderr. Quiet mode also disables operation-input prompts.

## Failures [#failures]

A failed command exits nonzero. With `--output json`, stderr contains one
structured error object:

<div className="docs-response">

```json
{
  "error": {
    "code": "INVALID_EXPORT",
    "message": "The encrypted session-key export is invalid or incomplete.",
    "nextStep": "Copy the entire import command from the dashboard. Do not paste a private key.",
    "retryable": false
  }
}
```

</div>

Use `error.code` for branching and `nextStep` for recovery. Do not parse human
error text. Keep stdout and stderr separate when consuming JSON.

A command can succeed while reporting `allowed: false`, `valid: false`, or a
submission with `status: "failed"`. Check the returned fields as well as the
exit status. A successful status lookup does not mean a successful transaction.

## Retry Safely [#retry-safely]

Do not repeat an execution just because the response was lost. Check its saved
submission ID, or reconcile the outcome first. Follow
[Handle Retries and Recovery](https://namera.ai/docs/cli/guides/transactions/handle-retries-and-recovery).

MCP reserves stdout for protocol messages and writes diagnostics to stderr.
Do not parse its stdout as ordinary CLI JSON.

Example output uses fixture accounts and hashes, captured with the CLI's output
formatters. Plain-text output is shown without terminal colors; your values and
relative expiry dates will differ.