CLI Reference

npm install -g @tpmjs/cli

tpm --version

# Authenticate
tpm auth login

# Search for tools
tpm tool search firecrawl

# Show trending tools
tpm tool trending

# Get tool info
tpm tool info @tpmjs/official-firecrawl scrapeTool

# Execute a tool
tpm tool execute firecrawl-scrape --input '{"url":"https://example.com"}'

# Generate MCP config for your AI client
tpm mcp config ajax/my-collection

# Interactive browser OAuth
tpm auth login

# Direct API key
tpm auth login --api-key YOUR_API_KEY

# Search by name
tpm tool search firecrawl

# Show more trending results
tpm tool trending --limit 20

# Get detailed info about a specific tool
tpm tool info @tpmjs/official-firecrawl scrapeTool

# Execute with inline JSON
tpm tool execute firecrawl-scrape --input '{"url":"https://example.com"}'

# Execute with input from file
tpm tool execute my-tool --input-file params.json

# Stream results
tpm tool execute my-tool --stream

# Initialize a new tool package (interactive)
tpm tool init

# Initialize with a name and template
tpm tool init my-tool --template rich

# Validate local tpmjs config in package.json
tpm tool validate

# Interactive chat session
tpm agent chat <agent-id>

# Send a single message
tpm agent chat <agent-id> "What tools can help with web scraping?"

# Add tools by ID
tpm collection add my-collection tool-id-1 tool-id-2

# Add tools from an npm package
tpm collection add my-collection --package @org/my-tools

# Search for tools and add them in one step
tpm collection add my-collection --search "firecrawl"
tpm collection add my-collection --search "web scraper" --category web --limit 3

# Remove a tool
tpm collection remove my-collection tool-id

# Import from file (IDs, one per line or JSON array)
tpm collection import my-collection --file tools.txt

# Update metadata
tpm collection update my-col --name "New Name" --public
tpm collection update my-col --no-public  # Make private

# Basic usage
tpm run -c ajax/unsandbox -t execute --args '{"code":"print(1)","language":"python"}'

# With environment variables
tpm run -c ajax/my-collection -t myTool --env API_KEY=xxx --env DEBUG=true

# Using process environment
OPENAI_API_KEY=xxx tpm run -c ajax/ai-tools -t generate

# JSON output for scripting
tpm run -c ajax/tools -t base64Encode --args '{"data":"hello"}' --json | jq .result

# Generate 3 test scenarios for a collection
tpm scenario generate my-collection --count 3

# Run all scenarios and see pass rates
tpm scenario run my-collection

# Test a specific scenario
tpm scenario test clu123abc456 --verbose

# Auto-detect client
tpm mcp config ajax/my-collection

# For specific clients
tpm mcp config ajax/my-col --client claude     # Claude Desktop
tpm mcp config ajax/my-col --client cursor     # Cursor
tpm mcp config ajax/my-col --client windsurf   # Windsurf

# Run as local MCP server
tpm mcp serve                                  # HTTP on port 3333
tpm mcp serve --stdio                          # stdio mode

# Check if your package has been discovered on tpmjs.com
tpm publish check @myorg/my-tool
tpm publish check              # Check current directory's package

# Preview how your tool will appear
tpm publish preview
tpm publish preview --path ./my-tool

# Run diagnostics
tpm doctor --verbose

# Open the interactive playground
tpm playground
tpm playground --web   # Open web version
tpm playground --tool firecrawl-scrape   # Start with a specific tool

# JSON output for scripting
tpm tool search firecrawl --json | jq '.data[0].name'

# Verbose mode for debugging
tpm doctor --verbose

{
  "apiUrl": "https://tpmjs.com/api",
  "defaultOutput": "human",
  "verbose": false,
  "analytics": false
}

import { TpmClient } from '@tpmjs/cli';

const client = new TpmClient({ apiKey: 'your-key' });
const tools = await client.searchTools('firecrawl');