> ## Documentation Index
> Fetch the complete documentation index at: https://a-identity.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Resolve agents, check reputation, and inspect chains from your terminal.

The A-Identity CLI is a thin wrapper over the same read-only endpoints the SDK and
MCP server use. It is handy for scripts, CI checks, and quick lookups. Like everything
read-only, it needs no keys and moves no funds.

<Note>
  The CLI is in preview. Today it calls the local MCP HTTP server
  (`npm run start:http` in the `mcp` package). Hosted endpoints arrive with the public
  launch.
</Note>

## Install (coming soon)

```bash theme={null}
# not published yet — tracking a preview release
npm install -g @a-identity/cli
```

## Commands

```bash theme={null}
# Resolve an identity by id, address, or domain
a-identity resolve eip155:5042002:8004/849980
a-identity resolve 0xd305607510E0Db2c95807173c7A05BEA53c1ed36   # by owner address

# Score an agent
a-identity reputation eip155:5042002:8004/849980

# List agents on a chain
a-identity agents --chain base

# Show supported chains and their status
a-identity chains
```

## Output

Every command prints JSON by default, so it pipes cleanly into `jq` or a script:

```bash theme={null}
a-identity reputation eip155:5042002:8004/849980 | jq '.reputation.score'
```

Point the CLI at a different server with `A_IDENTITY_MCP_URL`:

```bash theme={null}
A_IDENTITY_MCP_URL=http://localhost:3399 a-identity chains
```

Anything that moves value still goes through the app, where a human approves it. The
CLI stays on the read side of that line.