teardrop-cli 0.3.0

Command-line interface for the Teardrop AI agent platform

teardrop-cli

The fastest way to publish a tool, run an agent, and earn USDC — straight from your terminal.

Teardrop is the crypto-native AI agent platform. Tool authors publish webhooks, get paid per call in USDC, and never touch a dashboard. Agent users run prompts that automatically discover and pay for the right tools.

pip install teardrop-cli
teardrop quickstart        # 60-second guided onboarding

Already onboarded? Jump to Run an Agent or Publish a Tool.

---

Install

pip install teardrop-cli
teardrop --version

Requires Python ≥ 3.11.

---

60-Second Quickstart

The wizard walks you through sign-in, BYOK LLM setup, and your first agent run or scaffolded tool:

teardrop quickstart

Prefer the manual path? Pick a sign-in method:

# Wallet-first (no email needed) — generates a wallet on first run if you don't have one
teardrop auth login --siwe --generate-wallet

# Email + password
teardrop auth signup --email [e-mail] --org-name acme

# Already have an account
teardrop auth login --email [e-mail]

Then run your first agent:

teardrop run "Summarize the latest ETH gas trends"

---

Sign In

Goal	Command
Create account & org	teardrop auth signup
Generate a new wallet & sign in	teardrop auth login --siwe --generate-wallet [--save-key]
Sign in with wallet (existing key)	teardrop auth login --siwe --key-file wallet.key [--save-key]
Email + password	teardrop auth login --email [e-mail]
Pre-issued JWT	teardrop auth login --token <jwt>
Invite a team member	teardrop auth invite [e-mail]
Show identity	teardrop auth status
Sign out	teardrop auth logout

Private keys are never persisted by the CLI unless you pass --save-key. When saved, the key is stored in your OS keyring (never in a config file) and can be used for automatic re-authentication when the session token expires. An encrypted keyring backend is required — plaintext fallbacks are refused.

For machine-to-machine credentials, env-var precedence, and CI patterns, see docs/cli-reference.md.

---

Publish a Tool

Scaffold a starter spec, edit it, and publish:

teardrop tools init my_scraper       # writes ./tool.json
$EDITOR tool.json                    # set webhook_url, schema, price
teardrop tools probe my_scraper      # test webhook health before publishing
teardrop tools publish --from-file tool.json \
    --settlement-wallet 0xYourChecksumAddress

Or run the interactive wizard:

teardrop tools publish

Tool name rules: ^[a-z][a-z0-9_]*$, ≤ 64 chars. Prices are in atomic USDC (6 decimals): 5000 = $0.005 per call. Settlement wallet is required once before your first payout.

Test your webhook before publishing with teardrop tools probe <tool-name>. Optionally pass --auth-header-name and --auth-header-value if your webhook requires auth, or use --method and --payload to customize the probe request.

Manage existing tools: teardrop tools list | info | update | pause | delete | probe. Full reference: docs/cli-reference.md.

---

Earn

teardrop earnings balance            # marketplace balance
teardrop earnings history            # per-call history
teardrop earnings withdraw 10.00     # to your settlement wallet
teardrop earnings withdrawals        # past payouts

On-chain withdrawals typically settle in 1–5 minutes.

---

Run an Agent

teardrop run "What is the current ETH gas price?"

# Continue a thread
teardrop run "Follow up" --thread <thread-id>

# Pass structured context
teardrop run "Process this order" --context '{"order_id":"ord_123"}'

# Exclude specific tools
teardrop run "Summarize news" --exclude platform/web_search

# Estimate cost based on current pricing & config (no run performed)
teardrop run "Analyze this data" --estimate-cost

# Apply a tool policy from a file
teardrop run "Execute workflow" --policy-file policy.json

# Machine-readable output
teardrop run "..." --json --no-stream

# Include UI component data for dashboard export (adds ~60s overhead)
teardrop run "..." --json --with-ui

Streaming output renders Markdown live with inline tool calls and structured UI components. A token + cost summary prints at the end. By default, CLI output is optimized for scripting and automation (emit_ui=false); use --with-ui only if you need structured UI component data in the JSON output.

---

Automate Runs

Use interval schedules for recurring prompts and event triggers for inbound webhooks:

teardrop schedules create \
    --name hourly-briefing \
    --prompt "Summarize open incidents" \
    --interval-seconds 3600

teardrop schedules list
teardrop schedules runs <schedule-id>

teardrop event-triggers create \
    --name inbound-orders \
    --prompt "Validate and process this order payload"

teardrop event-triggers runs <trigger-id>
teardrop event-triggers rotate-secret <trigger-id>

event-triggers create and event-triggers rotate-secret print the signing secret once. Store it immediately.

Full reference: docs/cli-reference.md and docs/cli-reference.md.

---

Chat with an Agent

A stateful chat mode that automatically continues the same thread across invocations:

teardrop chat "What is the current ETH gas price?"   # auto-creates a thread
teardrop chat "Follow up on that"                     # continues the same thread
teardrop chat "Start fresh" --new                     # starts a new conversation
teardrop chat "Specific thread" --thread thr_abc123   # explicit thread by id
teardrop chat "..." --json                            # machine-readable output

The active thread id is stored in ~/.teardrop/config.toml and reused on your next teardrop chat call. The thread id is printed after every turn for copy/paste. All run flags (--context, --exclude, --policy-file, --estimate-cost, --with-ui, --no-stream) are supported.

Use teardrop run for one-shot, script-friendly calls — use teardrop chat for conversational interaction.

---

If a run fails on credit, check your balance and history:

teardrop balance             # current credits
teardrop balance credit-history   # past charges and top-ups

To add credits, visit teardrop.dev.

---

Agent Tools

List all tools visible to your agent (platform, marketplace subscriptions, and your own tools):

teardrop agent-tools list

---

Configure Your LLM

One-shot bring-your-own-key wizard:

teardrop llm-config byok

Or set explicitly:

# Quality tier (default)
teardrop llm-config set --provider anthropic --model claude-sonnet-4-6 --routing quality

# Cost tier
teardrop llm-config set --provider openrouter --model deepseek-chat --routing cost

# Speed tier
teardrop llm-config set --provider google --model gemini-3-flash --routing speed

Pipe a key from stdin to keep it out of shell history: --byok-key -. See docs/cli-reference.md for advanced tuning, BYOK details, and benchmarks.

---

Browse the Marketplace

teardrop marketplace list
teardrop marketplace search "weather"
teardrop marketplace info acme/weather
teardrop marketplace subscribe acme/weather
teardrop marketplace subscriptions

Browsing requires no authentication. Subscribed tools become immediately available to your agents.

---

Where to Go Next

• Full CLI reference — every flag, env-var precedence, exit codes, M2M auth, MCP servers, models benchmarks, config file, development.
• End-to-end test guide — running tests against a live API.
• teardrop.dev — platform docs and dashboard.

---

License

MIT. See LICENSE.