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

ParameterDescriptionExample
promptThe query text to populate in the chatprompt=Fix+this+bug
modelThe model name or ID to use (case-insensitive)model=claude-4-sonnet or model=gpt-5
modeQuery mode: Auto, Read, Write, or Composer (case insensitive)mode=write
projectAbsolute path to project (must have been opened in IDE before to have .idea folder)project=/Users/username/my-project
newchatReset the chat session before executing (value doesn’t matter)newchat

​
Available Models

For a full list of available models, please visit our Models page.

​
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-4+sonnet

​
Write Mode with GPT-5

Launch in Write mode for feature development: 
jetbrains://studio/firebender/chat?prompt=Build+feature&mode=write&model=gpt-5

​
Read Mode for Code Explanation

Use Read mode to understand existing code: 
jetbrains://idea/firebender/chat?prompt=Explain+code&mode=read

​
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-4+sonnet&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-4+sonnet"'
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-4+sonnet
  • Code Review: jetbrains://idea/firebender/chat?prompt=Review+this+code&mode=read
  • Feature Builder: jetbrains://studio/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.