Quickstart

Junie CLI is the agentic coding tool by JetBrains that provides an interactive terminal interface for developers to review, write, and modify code.

Step 1: Install Junie CLI

In the terminal or command prompt of your choice, run:

npm install -g @jetbrains/junie-cli

To verify the installation:

junie --version

                brew tap jetbrains-junie/junie
                brew update
                brew install junie
            

To verify the installation:

junie --version

Step 2: Start Junie in your project

Navigate to the root directory of the project where you want to use Junie CLI and run junie:

cd /path/to/your/project

junie

Step 3: Authenticate

On the Junie welcome screen, select one of the available authentication options:

Log in with your JetBrains Account.
Use Junie CLI as part of your subscription plan with JetBrains. When selecting this option, you'll be redirected to the JetBrains Account login page.
Use JUNIE_API_KEY.
Run Junie CLI with usage-based billing. When selecting this option, you'll be prompted to provide an access token. To generate your JUNIE_API_KEY access token, go to junie.jetbrains.com/cli.

Step 4: Type your prompt

Type the prompt in the interactive CLI, for example:

> give me an overview of this codebase

Use @ to attach a file or folder from the current project to the request context. To see the list of available slash commands and use them, type /.

Learn more about using Junie in the terminal

Non-interactive (headless) mode

You can run Junie CLI in headless mode, that is, programmatically without interactive UI, in CI/CD environments and build pipelines.

To add Junie to your CI/CD script:

# Install Junie CLI
npm install -g @jetbrains/junie-cli

# Authenticate and use Junie
junie --auth="$JUNIE_API_KEY" "Review and fix any code quality issues in the latest commit"

The junie command takes options and environment variables.

For more information and examples, see Headless mode.

Other scenarios

27 January 2026