npm package: @otonix/cli
Description: Otonix CLI — deploy autonomous agent tokens on Base via Clanker v4
Author: Otonix
Latest version: 2.8.0

# @otonix/cli

**Otonix CLI** — deploy autonomous agent tokens on Base via **Clanker v4 (Uniswap v4)**.

Each agent gets an isolated Base wallet. Tokens are deployed on-chain using the Clanker v4 protocol — no API key required, direct on-chain deploy. All tokens are verified by Otonix (@otonix_tech).

## Install

```bash
npm install -g @otonix/cli
```

Requires Node.js ≥ 18.

## Quick Start

```bash
# 1. Generate your creator wallet
otonix wallet generate
otonix wallet address
# → Fund it: ≥200 $OTX + 0.01 ETH (Base)

# 2. Create an agent (isolated Base wallet)
otonix agent:create --name "MyAgent"
otonix agent:info MyAgent
# → Fund agent with ~0.003 ETH (Base) for gas

# 3. Register agent — auto-sends 200 $OTX as activation fee
otonix agent:register --name "MyAgent"
# → Verifies on-chain, marks agent as active

# 4. Deploy a token!
otonix launch token \
  --agent "MyAgent" \
  --name "CoolToken" \
  --ticker "COOL" \
  --image "https://your-logo-url.png" \
  --description "My agent-launched token" \
  --twitter "yourhandle"
```

## Commands

### Wallet

```bash
otonix wallet generate     # Generate new Base creator wallet
otonix wallet address      # Show wallet address
otonix wallet balance      # Show ETH + $OTX balance
otonix wallet import       # Import wallet from private key
otonix wallet export       # Export private key (keep safe!)
```

### Agents

```bash
otonix agent:create --name <name>    # Create isolated agent wallet
otonix agent:register --name <name>  # Activate agent (auto-sends 200 $OTX)
otonix agent:info <name>             # Show address, balances, status
otonix agent:list                    # List all agents with status
otonix agent:remove <name>           # Remove agent from local config
```

### Launch

```bash
otonix launch token \
  --agent <name> \           # Agent name (must be registered)
  --name <token-name> \      # Token name  [required]
  --ticker <symbol> \        # Token ticker/symbol  [required]
  --image <url> \            # Logo URL (https:// or ipfs://)  [required]
  --description <text> \     # Token description  [required]
  --twitter <handle> \       # Your Twitter/X handle (optional)
  --devbuy <eth>             # Initial dev buy in ETH (default: 0)
```

### Other

```bash
otonix config        # Show config file location and settings
otonix --version     # Show CLI version
otonix --help        # Show all commands
```

## How Registration Works

Agent registration is fully automatic:

1. Run `otonix agent:register --name "MyAgent"`
2. CLI checks your creator wallet has ≥200 $OTX and ETH for gas
3. Confirms with you before sending
4. Auto-sends 200 $OTX from creator wallet → Otonix treasury on Base
5. Waits for on-chain confirmation
6. Marks agent as `✓ Registered & Active`

## Technical Details

| Property | Value |
|---|---|
| LP Protocol | Clanker v4 (Uniswap v4) |
| Pool type | POOL_POSITIONS.Standard |
| Fee config | FEE_CONFIGS.StaticBasic |
| Paired token | WETH on Base |
| Fee split | 80% creator (WETH) / 20% Otonix treasury |
| Chain | Base Mainnet |
| Verified by | Otonix (@otonix_tech) |

## Config

Stored at `~/.otonix/config.json`. Contains wallet and agent private keys — **keep this file safe and never share it**.

## Links

- Website: [otonix.tech](https://otonix.tech)
- Twitter: [@otonix_tech](https://x.com/otonix_tech)
- $OTX: [DexScreener](https://dexscreener.com/base/0xF7E2a6226Ffe0693DD85406AC3A8917cbea5DC40)