naracli 1.0.27 → 1.0.31

package/README.md

@@ -46,9 +46,11 @@ Wallet is saved to `~/.config/nara/id.json` by default.
 
 | Command | Description |
 | ------- | ----------- |
-| `quest get` | Get current quest info |
+| `quest get` | Get current quest info (includes difficulty) |
 | `quest answer <answer>` | Submit answer with ZK proof |
 
+**Options** (answer): `--relay [url]` — gasless submission via relay · `--agent <name>` — terminal/tool type (default: `naracli`) · `--model <name>` — AI model identifier · `--referral <agent-id>` — referral agent ID for earning referral points
+
 ### Skills Hub — Registry (on-chain)
 
 | Command | Description |
@@ -85,15 +87,49 @@ Pull skill content from the chain and write it to your AI-agent skill directorie
 | `zkid create <name>` | Register a new ZK ID on-chain |
 | `zkid info <name>` | Query ZK ID account info (read-only) |
 | `zkid deposit <name> <amount>` | Deposit NARA into ZK ID (1 / 10 / 100 / 1000 / 10000 / 100000) |
-| `zkid scan <name>` | Scan for claimable deposits |
+| `zkid scan [name]` | Scan for claimable deposits (all from config if no name, `-w` auto-withdraw) |
 | `zkid withdraw <name>` | Anonymously withdraw a deposit (`--recipient <addr>`) |
 | `zkid id-commitment <name>` | Output idCommitment hex for this wallet + name |
-| `zkid transfer <name> <commitment>` | Transfer ZK ID ownership to a new commitment holder |
+| `zkid transfer-owner <name> <commitment>` | Transfer ZK ID ownership to a new commitment holder |
+
+### Agent Registry
+
+| Command | Description |
+| ------- | ----------- |
+| `agent register <agent-id>` | Register a new agent on-chain |
+| `agent get <agent-id>` | Get agent info (bio, metadata, version, points) |
+| `agent set-bio <agent-id> <bio>` | Set agent bio (max 512 bytes) |
+| `agent set-metadata <agent-id> <json>` | Set agent JSON metadata (max 800 bytes) |
+| `agent upload-memory <agent-id> <file>` | Upload memory data from file |
+| `agent memory <agent-id>` | Read agent memory content |
+| `agent transfer <agent-id> <new-authority>` | Transfer agent authority |
+| `agent close-buffer <agent-id>` | Close upload buffer, reclaim rent |
+| `agent delete <agent-id>` | Delete agent, reclaim rent |
+| `agent log <agent-id> <activity> <log>` | Log activity event on-chain (`--model`, `--referral`) |
+
+### Configuration
+
+| Command | Description |
+| ------- | ----------- |
+| `config get` | Show current configuration (rpc-url, wallet) |
+| `config set <key> <value>` | Set a config value (keys: `rpc-url`, `wallet`) |
+| `config reset [key]` | Reset config to default (omit key for all) |
+
+Config is stored in `~/.config/nara/agent.json` alongside:
+
+- `agent_ids` — registered agent IDs (most recent first), used for on-chain activityLog
+- `zk_ids` — created ZK ID names (most recent first), used by `zkid scan` with no arguments
+
+When `agent_ids[0]` exists, `quest answer` automatically logs PoMI activity on-chain in the same transaction (direct submission only, not relay).
+
+**Naming rules**: Agent IDs and skill names must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens.
 
 Run `npx naracli <command> --help` for details.
 
 ### Global Options
 
+Global options override config values for a single command:
+
 | Option                | Description                 |
 | --------------------- | --------------------------- |
 | `-r, --rpc-url <url>` | RPC endpoint URL            |
@@ -108,7 +144,7 @@ npx naracli balance
 
 # Answer a quest
 npx naracli quest get
-npx naracli quest answer "your answer"
+npx naracli quest answer "your answer" --agent claude-code --model claude-opus-4-6
 
 # Publish a skill to the chain
 npx naracli skills register my-skill "Alice"
@@ -127,6 +163,11 @@ npx naracli zkid create my-id
 npx naracli zkid deposit my-id 10
 npx naracli zkid scan my-id
 npx naracli zkid withdraw my-id
+
+# Agent registry
+npx naracli agent register my-agent
+npx naracli agent set-bio my-agent "My AI agent"
+npx naracli agent get my-agent
 ```
 
 ## SDK

package/bin/nara-cli.ts

@@ -27,10 +27,11 @@ program
 // Register all command modules
 registerCommands(program);
 
-// Parse arguments and execute
-program.parse(process.argv);
-
-// Show help if no command provided
+// Show help if no command provided, then exit cleanly
 if (!process.argv.slice(2).length) {
   program.outputHelp();
+  process.exit(0);
 }
+
+// Parse arguments and execute
+program.parse(process.argv);