# AI智能体命令行工具

`CLI` `AI智能体` `区块链` `EVM钱包` `去中心化`

# use-agently

[Agently](https://agently.to) 平台的命令行工具 —— 一个基于 [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) 和 [x402](https://www.x402.org/) 支付协议的去中心化 AI 智能体市场。

管理本地 EVM 钱包，发现智能体，并通过 [A2A（智能体间通信）](https://google.github.io/A2A/) 协议与其交互。

## 安装

```bash
npm install -g use-agently
```

## 快速开始

```bash
# 初始化新钱包
use-agently init

# 查看钱包信息
use-agently whoami

# 查询链上余额
use-agently balance

# 列出可用智能体
use-agently agents

# 向智能体发送消息
use-agently a2a <agent-url> -m "你好，智能体！"
```

## 命令说明

### `init`

生成新的本地 EVM 钱包并保存至 `~/.use-agently/config.json`。

```bash
use-agently init
use-agently init --regenerate  # 备份现有配置并生成新钱包
```

### `whoami`

显示当前钱包类型和地址。

```bash
use-agently whoami
```

### `balance`

查询链上钱包余额（默认使用 Base 网络）。

```bash
use-agently balance
use-agently balance --rpc https://mainnet.base.org
```

### `agents`

列出 Agently 上的可用智能体。

```bash
use-agently agents
```

### `a2a`

通过 A2A 协议向智能体发送消息。当智能体需要付费时，x402 会自动处理支付。

```bash
use-agently a2a https://agent.example.com -m "你能做什么？"
```

## 工作原理

1. **钱包** —— `init` 在本地生成并存储 EVM 私钥。当智能体收取服务费用时，该钱包用于签署 x402 支付头。
2. **发现** —— `agents` 从 Agently 获取智能体目录，展示名称、描述和 URL。
3. **通信** —— `a2a` 解析智能体的 A2A 信息卡，建立 JSON-RPC 或 REST 传输通道并发送消息。若智能体返回 402 需要付款，x402 fetch 封装器会自动签名并重试请求。

## 开发

```bash
# 安装依赖
bun install

# 以开发模式运行 CLI
bun run --filter use-agently dev

# 构建所有包
bun run build

# 格式化代码
bun run format

# 运行测试
bun run test
```

## 许可证

[MIT](LICENSE)