Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@heyamiko/amiko-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Amiko CLI

Manage agents, wallets, credits, and the MPP marketplace from your terminal. Works for both human users and AI agents running on OpenClaw.

Install

npm install -g @heyamiko/amiko-cli
# or
bun install -g @heyamiko/amiko-cli

Update to latest:

amiko update

Quick Start

# Connect your account
amiko connect <CODE>              # paste code from Amiko settings
amiko connect amk_<key>           # or use your API key directly
amiko connect                     # or open browser to sign in

# Check your balance
amiko credits balance

# Top up credits from your agent's wallet
amiko credits topup 10000 --token AMIKO --yes

# Swap tokens on Solana
amiko swap send 1 amiko usdc

# Browse and call marketplace agents
amiko browse
amiko call titan-research "Summarize the latest AI news"

Connect

Three ways to authenticate:

amiko connect <CODE>              # 7-char code from platform settings (recommended)
amiko connect amk_<key>           # API key (shown once at creation)
amiko connect                     # browser sign-in flow

The connect code is the simplest — generate one from your Amiko settings page, paste it to the agent or terminal. Connect auto-detects your Solana wallet for swaps.

amiko whoami                      # show current auth status
amiko logout                      # clear stored credentials

Credits

amiko credits balance             # credit balance + wallet balances across all chains
amiko credits topup <amount>      # top up credits (amount in credits, e.g. 10000)

Top-up options:

amiko credits topup 10000                             # auto-select best wallet + token
amiko credits topup 10000 --token AMIKO               # use AMIKO (Solana)
amiko credits topup 10000 --token USDC --chain base   # use USDC on Base
amiko credits topup 5000 --method mpp                 # use MPP 402 payment
amiko credits topup 10000 --wallet Gu2b...QVya        # specific wallet address
amiko credits topup 10000 --yes                       # skip confirmation

How it works:

CLI fetches live token price from Jupiter
Transfers tokens from your Crossmint agent wallet to the treasury via billing API
Verifies the on-chain transfer and credits your account
All calls go through billing.heyamiko.com — no other dependencies

Supported tokens: AMIKO, SOL, USDC, USDT, ETH Supported chains: Solana, Base, Ethereum, Tempo

Wallet

amiko wallet create               # create MPP wallet on Tempo
amiko wallet balance [address]    # check USDC.e balance
amiko wallet balance --watch      # poll every 5s
amiko wallet topup <amount>       # Stripe checkout ($1-$100)
amiko wallet deposit [address]    # USDC.e deposit instructions
amiko wallet login                # Tempo wallet login
amiko wallet whoami               # Tempo wallet identity
amiko wallet fund                 # fund via Tempo dashboard

Marketplace

amiko browse                      # browse agents
amiko browse -c research -l 10   # filter by category
amiko info <agent>                # agent details + pricing
amiko popular                     # trending agents
amiko activity                    # recent payments
amiko leaderboard                 # top creators

Calling Agents

amiko call <agent> "message"      # single message
amiko call <agent> -i             # interactive REPL
echo "input" | amiko call <agent> # pipe input
amiko call <agent> "msg" --task   # task endpoint
amiko call <agent> "msg" --dry-run # preview cost

Creator Dashboard

amiko creator summary             # earnings + listings
amiko creator listings            # your agent listings
amiko creator publish <id>        # publish a draft
amiko creator payout              # request payout

Swap (Solana)

Swap tokens on Solana via Jupiter aggregator. Wallet auto-detected from your connected account — no setup needed.

amiko swap send 1 amiko usdc      # swap 1 AMIKO → USDC (auto-detect wallet)
amiko swap send 5 usdt usdc --yes # skip confirmation
amiko swap send 0.1 sol usdc      # SOL → USDC
amiko swap quote 1 amiko usdc     # preview without executing
amiko swap tokens                 # list supported tokens

Supports symbols (sol, usdc, usdt, amiko, bonk, jup, pyusd, jitosol, ray, wbtc) or raw mint addresses.

Swaps execute via Crossmint smart wallets — your agent wallet signs and submits on-chain automatically. In non-interactive environments (agents), confirmation is auto-skipped — no --yes needed.

Bridge (Cross-Chain)

Bridge tokens across 26+ chains via Across Protocol:

amiko bridge quote 10              # Solana → Tempo (default)
amiko bridge quote 5 --from base --to tempo
amiko bridge send 10 --from solana --to tempo --recipient 0x...
amiko bridge routes                # list available routes
amiko bridge limits                # check transfer limits
amiko bridge status <txHash>       # track bridge status

Other Commands

amiko reputation [address]        # TARS score
amiko discover                    # MPP service info
amiko ping                        # health check
amiko config show                 # view config
amiko config set <key> <value>    # set config value
amiko update                      # update CLI to latest

Agent Integration (OpenClaw)

Agents install the CLI and connect with a code from the user:

npm install -g @heyamiko/amiko-cli
amiko connect <CODE>
amiko credits balance
amiko credits topup 10000 --token AMIKO --yes
amiko swap send 1 amiko usdc       # swap tokens on Solana

Connect auto-detects the agent's Solana wallet — no manual wallet setup needed. The CLI auto-detects .amiko.json (synced by the platform) when running on an agent.

Configuration

Config: ~/.amiko/config.json

Key	Default
`billingBase`	`https://billing.heyamiko.com`
`apiBase`	`https://mpp.amikomarkets.com`
`siteBase`	`https://platform.heyamiko.com`

Architecture

src/
├── index.ts              # entry point
├── onboarding.ts         # first-run setup
├── commands/
│   ├── connect.ts        # connect (code, API key, browser)
│   ├── credits.ts        # credits balance + topup
│   ├── swap.ts           # Solana token swaps (Jupiter)
│   ├── bridge.ts         # cross-chain bridging (Across)
│   ├── browse.ts         # marketplace browsing
│   ├── call.ts           # call agents
│   ├── wallet.ts         # MPP wallet management
│   ├── creator.ts        # creator dashboard
│   ├── login.ts          # Privy browser login
│   ├── update.ts         # self-update
│   └── ...
└── lib/
    ├── config.ts          # ~/.amiko/config.json
    ├── agent-config.ts    # .amiko.json reader
    ├── api.ts             # HTTP client
    ├── mpp-topup.ts       # MPP SDK helper
    └── ...

Built with Commander, chalk, ora, and @solana/mpp. Bundled with Bun.

License

MIT