Installation

Install the plugin

Install JBang from Settings/Preferences > Plugins > Marketplace, or visit the JBang Marketplace page. Restart IntelliJ IDEA when requested.

JBang plugin in the Marketplace

Open a directory containing a JBang script, or create one with New > JBang Script from the Project view. No dedicated project type or module wizard is required.

Install JBang

The plugin invokes the JBang CLI for templates, script metadata, dependency resolution, Run, and Debug. Install JBang using the instructions at jbang.dev/download.

The executable is selected in this order:

  1. The path configured under Settings/Preferences > Tools > JBang

  2. $JBANG_HOME/bin/jbang

  3. ~/.jbang/bin/jbang

  4. jbang from PATH (jbang.cmd on Windows)

If automatic discovery is not suitable, set the full executable path in Tools > JBang. The same page controls automatic synchronization after file saves.

JBang settings

Supported IDE and JDK

The current plugin line targets IntelliJ IDEA 2026.2 or newer. Building the plugin requires JDK 25; scripts may request a different installed or JBang-managed JDK through //JAVA.