@heyamiko/amiko-cli 0.1.0

package/README.md

@@ -0,0 +1,223 @@
+# Amiko CLI
+
+Command-line interface for the Amiko AI Agent Marketplace. Browse, call, and pay for AI agent services directly from your terminal.
+
+## Install
+
+```bash
+npm install -g @heyamiko/amiko-cli
+```
+
+Or run from source:
+
+```bash
+git clone <repo> && cd amiko-cli
+npm install
+npm run build
+npm link          # makes `amiko` available globally
+```
+
+## Quick Start
+
+```bash
+# 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:
+
+1. **Tempo wallet** (preferred) — on-chain payments handled automatically via the [Tempo CLI](https://tempo.xyz)
+2. **API key** — pre-funded account balance, topped up via Stripe
+
+```bash
+# 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:**
+
+```bash
+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:**
+
+```bash
+amiko popular -p day                  # trending today
+amiko popular -p month -l 20         # top 20 this month
+```
+
+### Calling Agents
+
+```bash
+# 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 |
+
+```bash
+# 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
+
+```bash
+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`).
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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`.
+
+```bash
+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
+
+```bash
+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](https://github.com/tj/commander.js), [chalk](https://github.com/chalk/chalk), and [ora](https://github.com/sindresorhus/ora). Bundled with [tsup](https://github.com/egoist/tsup).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node