CLI reference

Specify input format for piped input (options: text, json).

Specify output format for print mode (options: text, json, json-stream).

Save JSON output to a file.

Name or path of a custom guidelines file to use instead of the default. See guidelines file resolution order.

Specify the model to be used by Junie CLI.

When not specified, Junie CLI uses the default model that is set dynamically.

For the list of supported model aliases, see available models.

Specify the path to the project directory where Junie will run. When not specified, the current project directory is used.

Use a specific session ID, or a junie://sessions/<id> session link, to resume a previous session. A session link can also be passed as the positional argument: junie junie://sessions/<id>. If none is provided, a new session ID is generated.

Disable the automated check for and download of the latest Junie CLI update on startup.

Start interactive mode with an initial prompt already submitted. The TUI opens and the prompt is auto-submitted after onboarding. Unlike --task, the session stays interactive — you can continue typing new prompts after the initial one completes.

Add process-local user guidelines to the top-level issue agent in every session, alongside guidelines loaded from files such as AGENTS.md. The value is not saved to settings or session history. If an ACP client also supplies a session system prompt, Junie CLI appends it after this value on a new line. Chat agents, custom agents, and subagents do not receive these instructions.

Start interactive mode in Plan Mode. Can be combined with --prompt to auto-submit a prompt in plan mode.

Provide the task description (alternative to positional argument).

Resume the last session, or the session specified by --session-id.

Turn on Brave Mode. Interactive mode only.

Run a visual demo of a feature using computer use. Requires a running Docker daemon and a model with Computer Use support.

Set the model reasoning effort level. Possible values: low, medium, high. Requires --model or JUNIE_MODEL.

Select the BYOK provider to use. When not set, the Junie or Custom model provider is used.

Enable local AI caches even when they are disabled in the configuration.

Limit the number of agent steps per task. Takes precedence over the MAX_STEPS environment variable and the step limit setting.

Copy the session given by --session-id into a new session and run the task there; the original session is left untouched. Cannot be combined with --resume.

Run the task with the interactive prompt and tools (the answer tool, chat modes) while still running unattended: the agent never asks the user anything. Requires a task.

Override the anonymous usage statistics sharing setting for this run. Accepts true or false.

Run a build from the specified channel for this invocation without changing the default channel. With junie update, switch the installed channel instead. Supported values: release, eap, nightly, and experimental.

Run a specific installed build. When combined with --channel, run the specified build from that channel for this invocation.

Reinstall the latest build of the current channel when used with junie update. The root command accepts this option only for managed launcher compatibility; it has no effect without update.

Deprecated compatibility option. It no longer selects the release channel; use --channel=release instead.

Deprecated compatibility option. It no longer selects the EAP channel; use --channel=eap instead.

Deprecated compatibility option. It no longer selects the nightly channel; use --channel=nightly instead.

Deprecated compatibility option. It no longer selects the experimental channel; use --channel=experimental instead.

Enable Agent Client Protocol (ACP) mode for IDE/editor integrations. See Junie for ACP clients for details.

Specify a custom path to the directory where Junie CLI will store caches.

This is useful for isolating data between different projects or when working in environments with restricted access to the default home directory.

Set the initial agent mode (classic or chat) for newly created sessions.

Show the help message and exit.

Show Junie CLI version.

Add an extra config.json file location. Can be specified multiple times.

Enable or disable loading configuration from the default locations: ~/.junie/config.json and <project>/.junie/config.json. Defaults to true.

Specify additional folders where MCP servers should be found. Can be specified multiple times to add several locations.

Enable or disable adding MCP servers from default locations (per-user and per-project). Defaults to true.

Specify additional folders where custom model profiles should be found. Can be specified multiple times.

Enable or disable adding custom models from the default per-user and per-project locations. Defaults to true.

Specify additional folders where agent skills should be found. Can be specified multiple times.

Enable or disable adding skills from the default per-user and per-project locations. Defaults to true.

Specify additional folders where custom slash commands should be found. Can be specified multiple times.

Enable or disable adding custom slash commands from the default per-user and per-project locations. Defaults to true.

Specify additional folders where custom agents should be found. Can be specified multiple times.

Enable or disable adding custom agents from the default per-user and per-project locations. Defaults to true.

Override the default extensions directory (~/.junie/extensions).

Start a merge-conflicts resolution task between the current branch and the specified branch or commit.

Start a rebase-conflicts resolution task for the specified branch or commit.

Start a code review task. Can be combined with a task description.