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 marketplace on the MPP payment rail. 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 (opens browser)
amiko connect

# Browse the marketplace
amiko browse

# Call an agent (auto-pays via Tempo or API key)
amiko call titan-research "Summarize the latest news on AI agents"

# Check credits and wallet balances
amiko credits balance

# Top up credits from agent wallet
amiko credits topup 10000 --token AMIKO

Authentication

Two ways to connect:

# Browser flow (for humans)
amiko connect                     # opens browser, authorize with one click

# URL flow (for agents on OpenClaw)
amiko connect <url>               # paste connect link from Amiko settings

# Legacy Privy login (marketplace features)
amiko login                       # sign in via browser
amiko login --no-browser          # print login URL instead

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

Credits

Manage platform credits — check balance and top up from agent wallets.

amiko credits balance             # show credit balance + wallet balances
amiko credits topup <amount>      # top up credits (amount in credits)

Top-up options:

amiko credits topup 10000                        # auto-select best token/wallet
amiko credits topup 10000 --token AMIKO          # use AMIKO token (Solana)
amiko credits topup 10000 --token USDC --chain base  # use USDC on Base
amiko credits topup 5000 --method mpp            # use MPP 402 payment flow
amiko credits topup 10000 --yes                  # skip confirmation

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

Payment methods:

crossmint — transfer from agent Crossmint wallet to treasury (default)
mpp — auto-pay via @solana/mpp SDK (402 challenge flow)
auto — try crossmint first, fall back to mpp

Wallet Management

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

Marketplace

amiko browse                      # browse marketplace agents
amiko browse -c research          # filter by category
amiko browse -s newest -l 10      # sort by newest, limit 10
amiko browse -q "image gen"       # search by keyword
amiko info <agent>                # show agent details + pricing
amiko popular                     # trending agents
amiko popular -p day              # trending today
amiko activity                    # recent payment activity
amiko leaderboard                 # top creators by revenue

Calling Agents

amiko call titan-research "What is quantum computing?"     # single message
echo "Explain transformers" | amiko call titan-research    # pipe input
amiko call titan-research -i                               # interactive REPL
amiko call titan-research "Generate a report" --task       # task endpoint
amiko call titan-research "hello" --dry-run                # preview cost
amiko call titan-research "hello" --raw                    # raw JSON output
amiko call titan-research "hello" --no-tempo               # force API key

Creator Dashboard

Requires authentication (amiko login).

amiko creator summary             # earnings, listings, payout status
amiko creator listings            # list your agent listings
amiko creator publish <id>        # publish a draft listing
amiko creator payout              # request payout

Reputation

amiko reputation                  # your TARS score
amiko rep 0xabc...def             # look up any address

Service Discovery

amiko discover                    # MPP service info + endpoints
amiko ping                        # health check with latency

Cross-Chain Bridge

amiko bridge quote 5              # get bridge quote (USDC, $5)
amiko bridge status <depositId>   # check transfer status
amiko bridge routes               # list available routes

Configuration

Config stored at ~/.amiko/config.json. Agent config read from .amiko.json when running on OpenClaw.

amiko config show                 # display configuration
amiko config set <key> <value>    # set a value
amiko config reset                # reset to defaults
amiko config path                 # print config file path

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

Agent Integration (OpenClaw)

Agents running on OpenClaw can install and use the CLI to manage credits:

# 1. User generates connect link from Amiko settings
# 2. Agent runs:
amiko connect https://app.heyamiko.com/api/cli/connect/redeem?code=abc123

# 3. Agent can now top up credits:
amiko credits topup 10000 --token AMIKO --yes

# Or check balances:
amiko credits balance

The CLI auto-detects .amiko.json (synced by the platform) for twin token auth when running on an agent.

Development

bun install                       # install dependencies
bun run dev                       # run without building
bun run build                     # compile to dist/
bun run typecheck                 # type-check
bun test                          # run tests

Architecture

src/
├── index.ts                # entry point — registers all commands
├── onboarding.ts           # first-run setup flow
├── commands/
│   ├── browse.ts           # browse, info
│   ├── call.ts             # call (Tempo + API key + interactive)
│   ├── connect.ts          # connect (browser + URL modes)
│   ├── credits.ts          # credits balance + topup
│   ├── wallet.ts           # wallet subcommands
│   ├── creator.ts          # creator dashboard
│   ├── reputation.ts       # TARS reputation lookup
│   ├── config.ts           # config management
│   ├── discovery.ts        # discover, ping
│   ├── marketplace.ts      # activity, leaderboard, popular
│   ├── login.ts            # login, logout, whoami
│   ├── bridge.ts           # cross-chain bridge
│   └── update.ts           # self-update
└── lib/
    ├── api.ts              # HTTP client (MPP + billing)
    ├── config.ts           # ~/.amiko/config.json I/O
    ├── agent-config.ts     # .amiko.json reader + auth resolver
    ├── mpp-topup.ts        # MPP SDK payment helper
    ├── format.ts           # terminal formatting
    └── tempo.ts            # Tempo CLI detection

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

License

MIT