@tpmjs/cli

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

Installation

``bash
npm install -g @tpmjs/cli
`

Quick Start

`bash


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

$3

`bash
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
`

$3

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

$3

`bash
tpm agent list # List your agents
tpm agent create # Create a new agent
tpm agent update # Update an agent
tpm agent delete # Delete an agent
tpm agent chat # Chat with an agent
`

$3

`bash
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
`

$3

Execute tools directly from collections via the MCP API:

`bash


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
`

$3

`bash
tpm mcp config # Generate MCP config
tpm mcp serve # Run as local MCP server
`

$3

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

Configuration

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

`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:

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

Verbose Mode

Use --verbose or -v for detailed output:

`bash
tpm doctor --verbose
``

License

MIT