beyhan/bifrost
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

first commit

Browse Source
This commit is contained in:
Beyhan Oğur
2026-04-26 21:52:23 +03:00
commit 880f412e2c
2662 changed files with 866266 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

90
docs/cli-agents/cursor.mdx Normal file
View File

@@ -0,0 +1,90 @@
---
title: "Cursor"
description: "Add Bifrost as a custom model in Cursor, configure MCP tools, and use virtual keys for team access control."
icon: "arrow-pointer"
---
[Cursor](https://cursor.com) is an AI-powered IDE that supports OpenAI-compatible APIs and MCP (Model Context Protocol). By connecting Cursor to Bifrost, you get access to any provider/model in your Bifrost configuration, plus MCP tools and governance features like virtual keys.
![Setting up Bifrost for Cursor](/media/ides/cursor-add-custom-model-1.png)
<Note>
If your Allowed Headers are already set to `*`, you can skip this note. If not and you face issues integrating Bifrost with Cursor, try switching to `*` or adding the specific headers required by your client. By default, Bifrost whitelists: `Content-Type`, `Authorization`, `X-Requested-With`, `X-Stainless-Timeout`, and `X-Api-Key`.
</Note>
## Setup
1. **Open Cursor Settings**
Press <key>Cmd</key>+<key>,</key> (macOS) or <key>Ctrl</key>+<key>,</key> (Windows/Linux) and navigate to **Models**.
2. **Enter your API key**
In the **OpenAI API Key** field, enter your Bifrost virtual key or provider API key.
3. **Override the base URL**
Toggle **Override OpenAI Base URL** to ON and enter your Bifrost endpoint:
<Note>
For cursor you need publicly accessible link for Bifrost.
</Note>
For deployed instances, use your Bifrost deployment URL (e.g., `https://bifrost.example.com/cursor`).
4. **Add custom models** (optional)
Type a model name in the **Add or search model** field using the `provider/model-name` format:
![Adding a custom model in Cursor](/media/ides/cursor-add-custom-model-4-custom-model.png)
Examples: `anthropic/claude-sonnet-4-5-20250929`, `openai/gpt-5`, `gemini-2.5-pro`
| Provider | Format | Example |
|----------|--------|---------|
| Anthropic | `anthropic/model-name` | `anthropic/claude-sonnet-4-5-20250929` |
| Gemini | `model-name` | `gemini-2.5-pro` |
| OpenAI | `openai/model-name` | `openai/gpt-5` |
| Bedrock | `bedrock/model-name` | `bedrock/anthropic.claude-3` |
| Vertex (non-Gemini) | `vertex/model-name` | `vertex/text-bison` |
| Other providers | `provider/model-name` | `groq/llama-3.3-70b-versatile` |
## Using Virtual Keys
Bifrost [Virtual Keys](/features/governance/virtual-keys) can be used as the OpenAI API Key in Cursor. Virtual keys let you enforce budgets, rate limits, and provider access controls for each user or team.
## Model Selection
Cursor assigns models to different features — **Chat**, **Agent**, **Inline Edit**, and **Tab Completion**. After configuring Bifrost, you can assign any `provider/model-name` to each feature for optimal cost and performance:
- Use a powerful model like `openai/gpt-5` or `anthropic/claude-sonnet-4-5-20250929` for Agent mode
- Use a fast model like `groq/llama-3.3-70b-versatile` for Tab completion
## Using Multiple Providers
Bifrost routes requests to the correct provider based on the model name. Use the `provider/model-name` format to access any configured provider through the single OpenAI-compatible endpoint:
```
anthropic/claude-sonnet-4-5-20250929
openai/gpt-5
gemini/gemini-2.5-pro
mistral/mistral-large-latest
```
### Supported Providers
Bifrost supports the following providers with the `provider/model-name` format:
`openai`, `anthropic`, `azure`, `gemini`, `vertex`, `bedrock`, `mistral`, `groq`, `cerebras`, `cohere`, `perplexity`, `xai`, `ollama`, `openrouter`, `huggingface`, `nebius`, `parasail`, `replicate`, `vllm`, `sgl`
<Warning>
Non-native models **must support tool use** for Cursor's agent mode and inline editing to work properly. Models without tool use support will only work for basic chat.
</Warning>
<Note>
Cursor's "Override OpenAI Base URL" is a global setting that applies to all OpenAI-compatible models. This works well with Bifrost since Bifrost handles routing to the correct provider based on the model name.
</Note>
## Observability
All Cursor requests through Bifrost are logged. Monitor them at `http://localhost:8080/logs` — filter by provider, model, or search through conversation content.