Deep Links

Launch Firebender with pre-configured queries using jetbrains:// URLs

Deep Link Integration

Firebender supports deep links through the jetbrains:// protocol, allowing you to launch the IDE and pre-populate queries with specific prompts, models, and configurations. This is particularly useful for automation, shortcuts, and integrating Firebender with external tools.

Prerequisites

To use deep links, you need to have JetBrains Toolbox installed on your system. The Toolbox App registers the jetbrains:// protocol handler that enables deep link functionality across all JetBrains IDEs.

Download JetBrains Toolbox from: https://www.jetbrains.com/toolbox-app/

URL Format

Deep links follow this pattern:

jetbrains://[ide]/firebender/chat?[parameters]

Where [ide] can be any of the following JetBrains IDE identifiers:

• idea - IntelliJ IDEA
• studio - Android Studio

See the full list of supported IDEs on the JetBrains products page.

And [parameters] are URL-encoded query parameters

Supported Parameters

Parameter	Description	Example
prompt	The query text to populate in the chat	prompt=Fix+this+bug
model	The model ID to use (case-insensitive)	model=claude-sonnet-4-20250514 or model=gpt-5
mode	Query mode: Write, Ask, Plan, or Composer (case insensitive)	mode=write
project	Absolute path to project (must have been opened in IDE before to have .idea folder)	project=/Users/username/my-project
newchat	Reset the chat session before executing (value doesn’t matter)	newchat

Available Models

For a full list of available model IDs, see available models.

Example URLs

Basic Query

Launch with a simple prompt:

jetbrains://idea/firebender/chat?prompt=Hello

Query with Specific Model

Use Claude for debugging assistance:

jetbrains://studio/firebender/chat?prompt=Debug+issue&model=claude-sonnet-4-20250514

Write Mode with GPT-5

Launch in Write mode for feature development:

jetbrains://studio/firebender/chat?prompt=Build+feature&mode=write&model=gpt-5

Ask Mode for Code Explanation

Use Ask mode to understand existing code without making changes:

jetbrains://idea/firebender/chat?prompt=Explain+code&mode=ask

Fresh Chat Session

Start a new chat session:

jetbrains://studio/firebender/chat?prompt=Fresh+start&newchat

Complex Query

Multiple parameters combined:

jetbrains://idea/firebender/chat?prompt=Refactor+authentication+logic&model=claude-sonnet-4-20250514&mode=write&newchat

Integration Examples

Shell Scripts

Create shortcuts in your shell profile:

# Add to ~/.bashrc or ~/.zshrc
alias fb-debug='open "jetbrains://studio/firebender/chat?prompt=Debug+current+issue&model=claude-sonnet-4-20250514"'
alias fb-refactor='open "jetbrains://idea/firebender/chat?prompt=Refactor+selected+code&mode=write"'

Browser Bookmarks

Save frequently used queries as browser bookmarks for quick access:

• Debug Helper: jetbrains://studio/firebender/chat?prompt=Help+debug+this+issue&model=claude-sonnet-4-20250514
• Code Review: jetbrains://idea/firebender/chat?prompt=Review+this+code&mode=read
• Feature Builder: jetbrains://idea/firebender/chat?prompt=Build+new+feature&mode=write&newchat

External Tool Integration

Integrate with project management tools, CI/CD pipelines, or custom automation scripts to launch Firebender with context-specific queries.

URL Encoding

Remember to URL-encode special characters in parameters:

• Spaces: + or %20
• Ampersands: %26
• Question marks: %3F
• Hash symbols: %23

Troubleshooting

If deep links aren’t working:

1. Check IDE Registration: Ensure your JetBrains IDE is properly registered to handle jetbrains:// URLs
2. Verify Plugin Installation: Make sure the Firebender plugin is installed and enabled
3. URL Format: Double-check the URL format and parameter encoding
4. IDE Running: The target IDE should be running for optimal performance

The deep link system will show error dialogs if there are issues processing the request, helping you identify and resolve problems quickly.