omp (gateway)

Route omp ’s LLM calls through the Respan gateway for automatic logging, caching, and model switching. omp loads custom providers from ~/.oh-omp/agent/models.yml, so only your RESPAN_API_KEY is needed.

Paste this into your coding agent:


Help me set up the Respan gateway with the omp integration.
Follow https://www.respan.ai/docs/integrations/gateway/omp.md

Setup

Install omp

Terminal


curl -fsSL https://omp.sh/install | sh

Or install from npm, which exposes the binary as oh-omp:

Terminal


npm install -g @oh-labs/oh-omp

Add Respan as a provider

Create or edit ~/.oh-omp/agent/models.yml:

YAML


providers:
  respan:
    baseUrl: https://gateway.respan.ai
    apiKey: RESPAN_API_KEY
    api: openai-completions
    models:
      - id: gpt-4o
        name: GPT-4o
      - id: claude-sonnet-4-5-20250929
        name: Claude Sonnet 4.5

apiKey is the name of the environment variable that holds your key. Export it in your shell profile:

Terminal


export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"

No separate provider key needed. The Respan gateway handles provider authentication.

Run omp

Terminal


omp --model respan/gpt-4o

For a one-shot, non-interactive run:

Terminal


omp -p --model respan/gpt-4o "your prompt"

All LLM calls now route through Respan.

Switch models

Add more entries under models and pick any of them with --model respan/<id>. Any of the 1000+ models available through the gateway work, for example:


gpt-4o
claude-sonnet-4-5-20250929
gemini/gemini-3.5-flash

See the full model list .