# Commands JetBrains Central CLI provides a set of direct CLI commands as well as an [interactive interface (TUI)](#interactive-interface). Everything you can do in the interface has a command equivalent. ## Common commands ### central status Show authentication, proxy, and agent status. ```BASH $ central status ⣿ Auth logged in (AI Pro) ⣿ Proxy running on :19516 ⣿ Agents Claude Agent, Codex ``` ### central run Run an agent with JetBrains Central CLI proxy credentials injected as environment variables. The proxy starts automatically if it is not already running. Anything after `--` is passed straight to the agent: ```BASH central run [-- extra-args...] ``` ```BASH $ central run codex -- "explain this code" ``` ### central add Configure an agent to route requests through the JetBrains Central CLI proxy. This modifies the agent's configuration file permanently. If that file already exists, a timestamped copy is saved next to it before changes are applied. ```BASH $ central add claude ``` Supported agent names are `claude`, `codex`, `gemini`, `junie` (alias `junie-cli`), and `pi` (alias `pi-dev`). ### central remove Remove JetBrains Central CLI configuration from an agent, restoring its original settings. ```BASH $ central remove claude ``` ## Proxy commands ### central proxy start Start the proxy in the background and exit. ```BASH $ central proxy start ✓ Proxy started on port 19516 (PID 12345) ``` The proxy runs as a daemon process. It survives terminal close and continues until explicitly stopped. [Read more about the proxy](cli-in-depth.html#components-proxy). ### central proxy stop Stop the running proxy and exit. ```BASH $ central proxy stop ✓ Proxy stopped ``` ## Account commands ### central login Authenticate with JetBrains Account. Opens a browser for OAuth 2.0 login. ```BASH $ central login ``` Alternatively, you can log in to a JetBrains Central Server instance and use AI Enterprise. If a Central Server login is triggered while you are already logged in with your JetBrains Account, a new login is started. ```BASH $ central --enterprise # Log in and open the menu $ central login --enterprise # Log in ``` | Flag | Description | Default | | --- | --- | --- | | `--enterprise` (alias: `--server`) | Authenticate against a JetBrains Central Server instance instead of JetBrains Account. Prompts interactively for the server URL. | `false` | ### central logout Clear credentials, delete the cached AI governance policy, and stop the proxy. The configuration file is preserved, so agents stay wired. ```BASH $ central logout ``` ## Info commands ### central limit Show your current AI usage limit for seat-based access, or quota for license-based access, reported in AI credits. `central quota` is kept as an alias. ```BASH $ central limit ``` ### central access Show enabled AI access sources for the logged-in user. Workspaces are listed first, followed by licenses. Passing a source ID switches the active AI access source. Workspace IDs are not shown in the list; license IDs are shown in the details after the licensed-to name. ```BASH $ central access $ central access workspace:org-123:ws-456 $ central access license:L5DSO53F1QP ``` ### central licenses A hidden temporary compatibility alias for `central access`. It prints a warning that license-based management was superseded by AI access-based management, then runs the access command. ```BASH $ central licenses ``` ### central log View the local request log. ```BASH $ central log ``` ### central config View the current JetBrains Central CLI configuration. ```BASH $ central config ``` To change a value, use `central config set `: ```BASH $ central config set log-level debug $ central config set port 19517 $ central config set release-track stable # follow a release channel $ central config set release-track 1.2.3 # pin a specific version $ central config set license-id A1B2C3D4E5 # alias for license-backed access $ central config set google-analytics on $ central config set google-analytics off $ central config set jumpscare-mode on $ central config set jumpscare-mode off ``` ### central update Resolve the update target. The precedence is `--target-version`, then the configured `release-track` — either a channel's latest published version or a pinned version. ```BASH $ central update $ central update --install # skip the prompt $ central update --target-version 1.2.3 --install # install a specific version ``` ### central uninstall Remove JetBrains Central CLI and all its data. You are asked to confirm unless `--yes` is passed. ```BASH $ central uninstall $ central uninstall --yes # skip the prompt ``` ### central agents List all supported agents and their current status. ```BASH $ central agents ``` Every agent is listed under a single Agents heading. Agents blocked by AI governance are dimmed and their status reads "blocked by AI governance". Agents the current session cannot use are dimmed with the reason instead — "not supported with service accounts", or "not supported with the bedrock protocol" — since a login method or a missing capability is not a policy decision. To refresh provisioned AI agent settings manually: ```BASH $ central agents refresh ``` This first checks organization feature flags from JetBrains Cloud using `org_user_token` as a bearer token. It downloads provisioning settings only when both `ai-seats` and `ai-paid-features` are enabled; otherwise it stores unrestricted settings (`settings: null`). ### central --version and central --help ```BASH $ central --version central 0.1.20 (commit: 7911b2e, built: 2025-02-08T10:30:00Z) ``` `central --help` (or `-h`) shows usage information. `-v` is a short form of `--version`. ## Environment variables | Variable | Description | Default | | --- | --- | --- | | `WIRE_PROXY_PORT` | Override the proxy listen port | `19516` | The environment variable takes precedence over the port saved in `~/.jetbrains-central/config.json`. ## Exit codes | Code | Meaning | | --- | --- | | `0` | Success | | `1` | Error, with the message printed to stderr | ## Interactive interface ```BASH central ``` The default entry point. It guides you through login, agent setup, and proxy management. On first run it walks you through the login process; on subsequent runs it opens the main menu directly. | Flag | Description | Default | | --- | --- | --- | | `--enterprise` (alias: `--server`) | Authenticate against a JetBrains Central Server instance instead of JetBrains Account | `false` | ### Main menu * Wire agents / Wire — permanently reroute agent requests through JetBrains Central CLI * Run agents / Run — run an agent for one session, with no configuration changes * More... — additional tools and settings * Exit When only one agent is detected, actions target it directly — Wire Claude Agent rather than a picker, or Reset Claude Agent if that agent is already wired. If you have installed an agent that AI governance blocks, the menu adds an Installed agents blocked by AI governance section listing it as dimmed and blocked. Blocked agents you have not installed are not shown there — see More... | Supported agents for the full list. ### More submenu * Quota (or Limit) — view your AI credit usage. The entry is named after whichever applies to your AI access source. * AI Logs — view the request log * Start proxy / Stop proxy — manage the background proxy * Under Settings: * Settings — proxy port, log level, release channel, jumpscares, privacy and analytics, show logs * Supported agents — install status, documentation links, and Refresh agent settings * AI Access — switch the active AI access source * Under Help: * Documentation * Report issue * Check for updates, Logout, and Uninstall JetBrains Central CLI ## See also ### Related [JetBrains Central CLI in depth](cli-in-depth.html) [Troubleshooting](troubleshooting.html)