opper-cli

Homebrew (macOS):

```bash

brew tap opper-ai/oppercli git@github.com:opper-ai/oppercli

brew install opper

```

Binary download (macOS ARM64):

```bash

sudo curl -o /usr/local/bin/opper https://github.com/opper-ai/oppercli/releases/latest/download/opper-darwin-arm64

sudo chmod 755 /usr/local/bin/opper

```

Other platforms: download from [GitHub Releases](https://github.com/opper-ai/oppercli/releases/latest) (opper-linux-amd64, opper-darwin-amd64, etc.).

Set up your API key:

```bash

opper config add default

```

Use multiple configurations with the --key flag:

```bash

opper config add staging

opper call --key staging myfunction "instructions" "input"

```

Execute an Opper function from the terminal:

```bash

# Basic call

opper call myfunction "respond in kind" "what is 2+2?"

# With a specific model

opper call --model anthropic/claude-4-sonnet myfunction "summarize this" "long text..."

# Pipe input from stdin

echo "what is 2+2?" | opper call myfunction "respond in kind"

```

| Command | Description |

|---------|-------------|

| call | Execute a function with instructions and input |

| functions | List, get, chat with, and run evaluations on functions |

| indexes | Manage knowledge base indexes (list, get, create, delete, add, query, upload) |

| models | Register, list, get, test, delete custom models, and list builtins |

| traces | Inspect execution traces |

| usage | Track usage analytics, tokens, and costs by tags |

| config | Manage API key configurations |

| version | Display CLI version |

Interactive chat with a function:

```bash

opper functions chat myfunction "Hello there!"

echo "Hello there!" | opper functions chat myfunction

```

Register custom models (uses LiteLLM identifiers):

```bash

# Register an Azure-deployed model

opper models create my-gpt4 azure/my-gpt4-deployment my-api-key '{"api_base": "https://my.openai.azure.com", "api_version": "2024-02-01"}'

# List registered models

opper models list

# List built-in models

opper models builtin

# Get details of a model

opper models get my-gpt4

# Test a model interactively

opper models test my-gpt4

# Delete a model

opper models delete my-gpt4

```

Query usage analytics with filtering and grouping:

```bash

# Usage for a date range grouped by tag

opper usage list --from-date=2025-05-15 --to-date=2025-05-16 --fields=total_tokens --group-by=model

# Time-precise query (RFC3339 format)

opper usage list --from-date=2025-05-15T14:00:00Z --to-date=2025-05-15T16:00:00Z --granularity=minute

# Export as CSV

opper usage list --out=csv

```

Note: cost and count are always included automatically. Valid --fields values: total_tokens, prompt_tokens, completion_tokens. Do NOT pass count as a field.

| Flag | Description |

|------|-------------|

| --debug | Enable diagnostic output |

| --key | API key configuration to use (default: "default") |

| -h, --help | Show help for any command |

• Missing config: Run opper config add default before using any commands.
• Wrong argument order for call: It's opper call , not opper call .
• Model identifiers: Use LiteLLM format (azure/deployment-name, anthropic/claude-4-sonnet), not raw model names.
• Piping with chat: When piping, the function name still comes first: echo "hi" | opper functions chat myfunction.

• For function management details, see [references/FUNCTIONS.md](references/FUNCTIONS.md)
• For index/knowledge base operations, see [references/INDEXES.md](references/INDEXES.md)
• For usage analytics and cost tracking, see [references/USAGE.md](references/USAGE.md)
• For API key configuration, see [references/CONFIG.md](references/CONFIG.md)

• opper-api: Use when you need the full REST API reference for HTTP-based integrations.
• opper-python-sdk: Use when building Python applications with the Opper SDK.
• opper-node-sdk: Use when building TypeScript applications with the Opper SDK.

When this skill's content may be outdated, resolve using this priority:

1. Installed CLI — run opper --help and subcommand help to check current commands and options
2. Source code: https://github.com/opper-ai/oppercli