CLI Examples

Complete end-to-end ToolPlexer CLI workflows.

Search the web

# 1. Discover capabilities
toolplexer discover -q "web search"

# 2. Inspect the endpoint schema and price
toolplexer inspect -p mock -e /web-search

# 3. Start a small run
toolplexer run -p mock -e /web-search \
  -i '{"query":"AI agent tooling","maxResults":5}'
# → Run ID: <run-id>

# 4. Retrieve the results
toolplexer runs get -r <run-id> -o search-results.json

Use a file for complex input

cat > params.json <<'EOF'
{
  "query": "restaurants in San Francisco",
  "maxResults": 10
}
EOF

toolplexer inspect -p mock -e /web-search
toolplexer run -p mock -e /web-search -i @params.json
toolplexer runs get -r <run-id> -o results.json

Compare capabilities

Run separate searches and inspect the candidates before choosing an endpoint:

toolplexer discover -q "twitter posts"
toolplexer discover -q "linkedin posts"
toolplexer inspect -p mock -e /web-search

Use --json when piping results to jq or another program:

toolplexer discover -q "product reviews" --json | jq '.items'

On this page