TPMJS command-line interface for AI tool discovery and execution
npm install @tpmjs/cliCommand-line interface for TPMJS - the universal tool registry for AI agents.
``bash`
npm install -g @tpmjs/cli
`bashSearch for tools
tpm tool search firecrawl
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=trueUsing process environment
OPENAI_API_KEY=xxx tpm run -c ajax/ai-tools -t generateJSON 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
``MIT