Ajax Davis 154f000505 feat(cli): add @tpmjs/cli package and browser auth page

- Create comprehensive CLI with oclif framework
- Add commands: auth, tool, agent, collection, mcp, publish
- Add doctor, playground, and update commands
- Add /cli/auth page for browser-based OAuth flow
- Publish to npm as @tpmjs/cli@0.1.2

2026-01-18 06:12:34 +10:00

2.4 KiB

Raw Blame History

@tpmjs/cli

Command-line interface for TPMJS - the universal tool registry for AI agents.

Installation

npm install -g @tpmjs/cli

Quick Start

# Search for tools
tpm tool search firecrawl

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

# Show trending tools
tpm tool trending

# Authenticate
tpm auth login --api-key YOUR_API_KEY

# List your agents
tpm agent list

# List your collections
tpm collection list

# Generate MCP config
tpm mcp config ajax/ajax-collection

Commands

Authentication

tpm auth login           # Login with API key or browser OAuth
tpm auth logout          # Log out
tpm auth status          # Show authentication status
tpm auth whoami          # Show current user info

Tools

tpm tool search [query]  # Search for tools
tpm tool info <pkg> <tool>  # Get tool details
tpm tool trending        # Show trending tools
tpm tool validate        # Validate local tpmjs config

Agents

tpm agent list           # List your agents
tpm agent create         # Create a new agent
tpm agent update <id>    # Update an agent
tpm agent delete <id>    # Delete an agent
tpm agent chat <id>      # Chat with an agent

Collections

tpm collection list      # List your collections
tpm collection create    # Create a collection
tpm collection add       # Add tools to a collection
tpm collection remove    # Remove tools from a collection

MCP Integration

tpm mcp config <user/collection>  # Generate MCP config
tpm mcp serve                      # Run as local MCP server

Utilities

tpm doctor               # Run diagnostic checks
tpm update               # Update CLI to latest version

Configuration

Config is stored in ~/.tpmjs/config.json:

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

Credentials are stored securely in ~/.tpmjs/credentials.json.

Environment Variables

TPMJS_API_KEY - API key for authentication
TPMJS_API_URL - Custom API URL (default: https://tpmjs.com/api)

Output Formats

All commands support --json flag for machine-readable output:

tpm tool search firecrawl --json | jq '.data[0].name'

Verbose Mode

Use --verbose or -v for detailed output:

tpm doctor --verbose

License

MIT

2.4 KiB Raw Blame History