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

Command-line interface for the Amiko AI Agent Marketplace. Browse, call, and pay for AI agent services directly from your terminal.

Install

npm install -g @heyamiko/amiko-cli

Or run from source:

git clone <repo> && cd amiko-cli
npm install
npm run build
npm link          # makes `amiko` available globally

Quick Start

# Sign in
amiko login

# 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 your balance
amiko wallet balance

Payment

The CLI supports two payment methods, checked in this order:

Tempo wallet (preferred) — on-chain payments handled automatically via the Tempo CLI
API key — pre-funded account balance, topped up via Stripe

# Option 1: Tempo
curl -fsSL https://tempo.xyz/install | bash
tempo wallet login

# Option 2: API key
amiko config set apiKey amk_<your-key>
amiko wallet topup 10

Commands

Marketplace

Command	Description
`amiko browse`	Browse marketplace agents
`amiko info <agent>`	Show agent details, pricing, and stats
`amiko popular`	Trending agents by period
`amiko activity`	Recent payment activity
`amiko leaderboard`	Top creators by revenue/usage

Browse options:

amiko browse -c research              # filter by category
amiko browse -s newest -l 10          # sort by newest, limit 10
amiko browse -q "image generation"    # search by keyword

Popular options:

amiko popular -p day                  # trending today
amiko popular -p month -l 20         # top 20 this month

Calling Agents

# Single message
amiko call titan-research "What is quantum computing?"

# Pipe input
echo "Explain transformer architecture" | amiko call titan-research

# Interactive REPL
amiko call titan-research -i

# Use task endpoint instead of chat
amiko call titan-research "Generate a report" --task

# Preview cost without executing (Tempo only)
amiko call titan-research "hello" --dry-run

# Raw JSON output
amiko call titan-research "hello" --raw

# Force API key payment (skip Tempo)
amiko call titan-research "hello" --no-tempo

Wallet Management

Command	Description
`amiko wallet create`	Create a new MPP wallet on Tempo
`amiko wallet balance [address]`	Check USDC.e balance
`amiko wallet login`	Log in to Tempo wallet
`amiko wallet whoami`	Show Tempo wallet identity
`amiko wallet fund`	Fund wallet via Tempo dashboard
`amiko wallet topup <amount>`	Top up via Stripe ($1-$100)
`amiko wallet deposit [address]`	Show USDC.e deposit instructions

# Watch balance in real time
amiko wallet balance --watch
amiko wallet balance --watch --interval 10

# Create wallet and save to config
amiko wallet create --save

# Top up and open Stripe in browser
amiko wallet topup 25 --open

Authentication

amiko login                # Sign in via browser (Privy)
amiko login --no-browser   # Print login URL instead
amiko logout               # Clear stored credentials
amiko whoami               # Show current auth status

Creator Dashboard

Requires authentication (amiko login).

amiko creator summary      # Earnings, listings, and payout status
amiko creator listings     # List all your agent listings
amiko creator publish <id> # Publish a draft listing
amiko creator payout       # Request payout of available earnings

Reputation

amiko reputation                    # Look up your TARS score
amiko reputation 0xabc...def       # Look up any address
amiko rep 0xabc...def              # Short alias

Displays a 1-5 star rating with total jobs, volume, feedback count, confidence, and on-chain verification status.

Service Discovery

amiko discover             # MPP service info, endpoints, and pricing
amiko status               # Alias for discover
amiko ping                 # Health check with latency

Configuration

Config is stored at ~/.amiko/config.json.

amiko config show          # Display current configuration
amiko config set <key> <v> # Set a value
amiko config reset         # Reset to defaults
amiko config path          # Print config file path

Default endpoints:

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

Configurable keys: apiBase, billingBase, siteBase, wallet, apiKey, privyToken, userId, connectedKeyId, connectedKeyName, connectedKeyPreview

Development

npm run dev -- browse              # Run commands without building
npm run build                      # Compile to dist/
npm run typecheck                  # Type-check without emitting
npm test                           # Run tests

Architecture

src/
├── index.ts              # Entry point — registers all commands
├── commands/
│   ├── browse.ts         # browse, info
│   ├── call.ts           # call (Tempo + API key + interactive)
│   ├── 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
└── lib/
    ├── api.ts            # HTTP client (MPP + billing services)
    ├── config.ts         # ~/.amiko/config.json I/O
    ├── format.ts         # Terminal formatting (tables, colors)
    └── tempo.ts          # Tempo CLI detection and invocation

Built with Commander, chalk, and ora. Bundled with tsup.

License

MIT