CLI Reference

Installation

npm install -g @indiegent/cli

Or with your preferred package manager:

yarn global add @indiegent/cli
pnpm add -g @indiegent/cli

Authentication

indiegent login

Authenticate with IndieGent. Opens your browser for a secure OAuth device flow — approve the login, and your CLI is authenticated.

$ indiegent login
→ Opening browser for authentication...
→ Waiting for approval...
✓ Logged in as stuart@example.com

indiegent logout

Clear your local authentication token.

$ indiegent logout
✓ Logged out

Agent Wallets

indiegent agents list

List all your agent wallets with live USDC balances.

$ indiegent agents list
┌──────────────┬──────────────────┬──────────┬────────┐
│ Name         │ Address          │ Balance  │ Status │
├──────────────┼──────────────────┼──────────┼────────┤
│ Research Bot │ 0x7a3f...8b2c    │ $25.00   │ active │
│ Email Agent  │ 0xabcd...ef01    │ $142.00  │ active │
│ Trading Bot  │ 0x9876...abcd    │ $3.20    │ active │
└──────────────┴──────────────────┴──────────┴────────┘

indiegent agents create

Create a new agent wallet.

$ indiegent agents create --name "Research Bot" --cap 50

✓ Agent wallet created
  Name:    Research Bot
  Address: 0x7a3f...8b2c
  Cap:     $50.00

indiegent agents fund

Fund an agent wallet with USDC. On first funding, gas (ETH) is automatically sponsored.

$ indiegent agents fund "Research Bot" 25

✓ Funded $25.00 USDC to Research Bot
✓ Gas sponsored (0.00005 ETH)

indiegent agents key

Reveal the private key for an agent wallet.

$ indiegent agents key "Research Bot"

⚠ Private key (do not share):
  0x4c8a...f2e1

indiegent agents env

Output environment variables for an agent. Designed to be used with eval to inject credentials into a subprocess.

$ indiegent agents env "Research Bot"
export INDIEGENT_AGENT_KEY="0x4c8a...f2e1"
export INDIEGENT_AGENT_ADDRESS="0x7a3f...8b2c"

# Usage: inject into your agent process
$ eval $(indiegent agents env "Research Bot")
$ node my-agent.js

indiegent agents drain

Drain all USDC from an agent wallet back to your connected wallet.

$ indiegent agents drain "Research Bot"

✓ Drained $25.00 USDC from Research Bot
  Tx: 0xabc1...def4

indiegent agents txns

View transaction history for an agent.

$ indiegent agents txns "Research Bot" --limit 10

┌──────────┬──────────┬────────────┬─────────────────────┐
│ Type     │ Amount   │ To/From    │ Time                │
├──────────┼──────────┼────────────┼─────────────────────┤
│ fund     │ +$25.00  │ 0xYour...  │ 2025-03-20 14:30    │
│ payment  │ -$0.03   │ 0xServ...  │ 2025-03-20 15:12    │
│ payment  │ -$0.01   │ 0xApi...   │ 2025-03-20 15:14    │
└──────────┴──────────┴────────────┴─────────────────────┘

indiegent agents topup

Configure auto-topup rules for an agent.

$ indiegent agents topup "Research Bot" --threshold 5 --amount 20

✓ Auto-topup configured for Research Bot
  When balance drops below $5.00, refill to $20.00

Balance

indiegent balance

View aggregate balance across all agent wallets.

$ indiegent balance

Total USDC: $170.20 across 3 agents
  Research Bot:  $25.00
  Email Agent:   $142.00
  Trading Bot:   $3.20

API Keys

indiegent api-keys create

Generate an API key for programmatic access. The raw key is shown once and never stored — save it immediately.

$ indiegent api-keys create --name "CI/CD Pipeline"

✓ API key created
  Name: CI/CD Pipeline
  Key:  ig_live_abc123def456...

⚠ Save this key — it won't be shown again.

indiegent api-keys list

List all your API keys (keys are masked).

$ indiegent api-keys list

┌──────────────────┬──────────────┬─────────────────────┐
│ Name             │ Prefix       │ Created             │
├──────────────────┼──────────────┼─────────────────────┤
│ CI/CD Pipeline   │ ig_live_abc… │ 2025-03-20          │
│ Development      │ ig_test_xyz… │ 2025-03-18          │
└──────────────────┴──────────────┴─────────────────────┘

Environment Variables