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
amiko swap quote SOL USDC 1.0
amiko swap send SOL USDC 1.0 --yes

# 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.

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

Swap

amiko swap quote <from> <to> <amount>    # get Jupiter quote
amiko swap send <from> <to> <amount>     # execute swap
amiko swap tokens                         # list supported tokens

Swaps execute via Jupiter on Solana using the agent's Crossmint wallet.

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 send <to> <amount>   # send tokens via Crossmint wallet
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

Bridge

amiko bridge quote <amount>       # cross-chain bridge quote via Across Protocol
amiko bridge send <amount>        # execute bridge transfer
amiko bridge status <txHash>      # check bridge status
amiko bridge routes               # available bridge routes
amiko bridge limits               # min/max limits per route

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

The CLI auto-detects .amiko.json (synced by the platform) when running on an agent. It checks:

$OPENCLAW_WORKSPACE_DIR/.amiko.json
$OPENCLAW_HOME/.openclaw/workspace/.amiko.json
/data/.openclaw/workspace/.amiko.json
Walking up from cwd

When .amiko.json is found, the CLI automatically authenticates using the twin token -- no manual connect needed.

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 (Commander)
├── onboarding.ts         # first-run setup
├── commands/
│   ├── connect.ts        # connect (code, API key, browser)
│   ├── credits.ts        # credits balance + topup
│   ├── swap.ts           # Jupiter token swaps
│   ├── bridge.ts         # Across Protocol cross-chain bridge
│   ├── browse.ts         # marketplace browsing
│   ├── call.ts           # call agents
│   ├── wallet.ts         # wallet management (Crossmint + Tempo)
│   ├── creator.ts        # creator dashboard
│   ├── login.ts          # Privy browser login
│   ├── update.ts         # self-update
│   ├── config.ts         # config management
│   ├── discovery.ts      # MPP service info
│   ├── marketplace.ts    # activity, leaderboard, popular
│   └── reputation.ts     # TARS score
└── lib/
    ├── config.ts          # ~/.amiko/config.json
    ├── agent-config.ts    # .amiko.json reader + auto-auth
    ├── api.ts             # HTTP client for MPP + billing
    ├── format.ts          # table, usd, truncAddr helpers
    ├── mpp-topup.ts       # MPP SDK topup helper
    ├── across.ts          # Across Protocol bridge
    └── tempo.ts           # Tempo wallet CLI wrapper

Built with Commander, chalk, ora, @solana/mpp, and @crossmint/wallets-sdk. Bundled with Bun.

License

MIT