tpmjs/packages/cli
Ajax Davis 48c41e8733 feat: add use cases marketing product with AI-generated content
Transform qualifying scenarios into marketing-ready use cases with:
- AI-generated titles, descriptions, ROI estimates, business value
- Persona/industry/category taxonomy for targeting
- Browseable feed with filtering and ranking
- SEO-optimized case study pages
- Daily cron job for generation and ranking

Database:
- Add Persona, Industry, Category lookup tables
- Add UseCase model with marketing content fields
- Add junction tables for personas/industries/categories
- Add SocialProof model for cached metrics

API:
- GET /api/use-cases - Global directory with filtering
- GET /api/use-cases/[id] - Individual use case details
- GET /api/public/users/[username]/collections/[slug]/use-cases
- POST /api/cron/use-cases - Nightly generation job

Frontend:
- /use-cases - Global feed with persona dropdown
- /use-cases/[slug] - SEO case study page
- /[username]/collections/[slug]/use-cases - Collection feed
- UseCasesFeed component - Sortable table component
- UseCaseCaseStudy component - Full case study layout
2026-01-20 16:17:35 +10:00
..
bin feat(cli): add @tpmjs/cli package and browser auth page 2026-01-18 06:12:34 +10:00
src feat: add use cases marketing product with AI-generated content 2026-01-20 16:17:35 +10:00
oclif.manifest.json feat(web): add scenarios UI - explorer, detail, and homepage section 2026-01-19 05:57:29 +10:00
package.json chore(cli): bump version to 0.1.4 for npm publish 2026-01-19 05:50:32 +10:00
README.md feat(cli): add @tpmjs/cli package and browser auth page 2026-01-18 06:12:34 +10:00
tsconfig.json feat(cli): add @tpmjs/cli package and browser auth page 2026-01-18 06:12:34 +10:00
tsup.config.ts feat: add use cases marketing product with AI-generated content 2026-01-20 16:17:35 +10:00

@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