docs/getting-started/installing-cline.mdx
Create your account at app.cline.bot for access to multiple AI models, seamless setup without managing API keys, and occasional free inferencing.
Choose your platform: VS Code, Cursor, Antigravity, JetBrains IDEs, CLI (macOS/Linux preview), Zed, Neovim, VSCodium, or Windsurf.
<Tip>
If VS Code shows "Running extensions might..." dialog, click **Allow**. If you don't see the Cline icon, restart VS Code.
</Tip>
<Steps>
<Step title="Open your JetBrains IDE">
Launch IntelliJ IDEA, PyCharm, WebStorm, or any JetBrains IDE.
</Step>
<Step title="Open Settings">
Press `Ctrl+Alt+S` (Windows/Linux) or `Cmd+,` (macOS).
</Step>
<Step title="Navigate to Plugins">
Go to **Plugins** → **Marketplace** tab.
</Step>
<Step title="Install Cline">
Search for "Cline" and click **Install**.
</Step>
<Step title="Restart IDE">
Restart your IDE to complete the installation.
</Step>
</Steps>
Find Cline in **View** → **Tool Windows** → **Cline** (usually on the right side).
<AccordionGroup>
<Accordion title="Alternative Installation Methods">
**Browser Install:**
1. Go to the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/28247-cline)
2. Click **Install to IDE**
3. Confirm in your IDE and restart
**Manual Install:**
1. Download from the [marketplace page](https://plugins.jetbrains.com/plugin/28247-cline)
2. Go to **Settings** → **Plugins** → gear icon → **Install Plugin from Disk**
3. Select the downloaded `.zip` file and restart
</Accordion>
<Accordion title="Terminal Integration Difference">
JetBrains shows terminal output differently than VS Code. In VS Code, output streams directly to chat. In JetBrains, output appears in collapsible "Command Output" sections.
Commands execute successfully in both. Expand the section to see results in JetBrains.
</Accordion>
</AccordionGroup>
Cline CLI runs AI coding agents directly in your terminal. Use it for automated code reviews in CI/CD, multi-instance development, or shell workflow integration.
<Steps>
<Step title="Install Node.js 20+">
Check your version with `node --version`. If needed, visit [nodejs.org](https://nodejs.org) or use nvm.
</Step>
<Step title="Install Cline CLI">
Run `npm install -g cline` in your terminal.
</Step>
<Step title="Authenticate">
Run `cline auth` to sign in and configure your AI model provider.
</Step>
<Step title="Run Cline">
Run `cline` to start an interactive session, or `cline "Your task here"` for headless execution.
</Step>
</Steps>
<Tip>
Want to learn more? See the [Cline CLI documentation](/cline-cli/getting-started) for advanced usage patterns like multi-instance development and CI/CD integration.
</Tip>
<Steps>
<Step title="Install Node.js 20+">
Check your version with `node --version`. If needed, visit [nodejs.org](https://nodejs.org) or use nvm.
</Step>
<Step title="Install Cline CLI">
```bash
npm install -g cline
```
</Step>
<Step title="Authenticate">
```bash
cline auth
```
</Step>
<Step title="Configure your editor">
<Tabs>
<Tab title="Zed">
Open Zed settings (`Cmd/Ctrl + ,`) and add Cline to your `settings.json`:
```json
{
"agent_servers": {
"Cline": {
"type": "custom",
"command": "cline",
"args": ["--acp"],
"env": {}
}
}
}
```
Then open the AI assistant panel, select **Cline** from the agent dropdown, and start coding.
</Tab>
<Tab title="Neovim (agentic.nvim)">
Install [agentic.nvim](https://github.com/carlos-algms/agentic.nvim) using lazy.nvim:
```lua
{
"carlos-algms/agentic.nvim",
opts = {
provider = "cline-acp",
acp_providers = {
["cline-acp"] = {
command = "cline",
args = {"--acp"},
},
},
},
keys = {
{"<C-\\>", function() require("agentic").toggle() end, mode={"n","v","i"}, desc="Toggle Cline Chat"},
},
}
```
Press `<C-\>` to toggle the Cline chat panel.
</Tab>
<Tab title="Neovim (avante.nvim)">
Follow the [avante.nvim documentation](https://github.com/yetone/avante.nvim) for configuring external ACP agents and point it to `cline --acp`.
</Tab>
</Tabs>
</Step>
</Steps>
<Tip>
For full details on ACP editor integrations—including JetBrains ACP setup and troubleshooting—see the [ACP Editor Integrations](/cline-cli/acp-editor-integrations) guide.
</Tip>
<Steps>
<Step title="Open your editor">
Launch VSCodium, Windsurf, or another Open VSX-compatible editor.
</Step>
<Step title="Open Extensions">
Press `Ctrl/Cmd + Shift + X`.
</Step>
<Step title="Search for Cline">
Type "Cline" in the search bar.
</Step>
<Step title="Install">
Select "Cline" by saoudrizwan and click **Install**.
</Step>
<Step title="Reload">
Reload your editor if prompted.
</Step>
</Steps>
Look for the Cline icon in your Activity Bar or use the Command Palette.
Open Cline in your editor:
Sign in by clicking the Sign Up button in the Cline interface. You'll be redirected to app.cline.bot to authenticate.
<Tip> Learn more about [authorizing with Cline](/getting-started/authorizing-with-cline), including how OAuth authentication works, using API keys with other providers, and troubleshooting auth issues. </Tip>Start building! After signing in, you'll automatically return to your editor-Cline is ready to help.
For the best coding experience, we recommend moving Cline to the right sidebar. This keeps your project files visible on the left while you chat with Cline on the right, giving you full visibility of your codebase as Cline works.
<Tabs> <Tab title="VS Code"> <Steps> <Step title="Align Extension View"> Make sure your extension view is aligned vertically to the left. </Step> <Step title="Open Right Side View"> Click the button that opens the right side panel (typically used for GitHub Copilot chat), or use `Option + Cmd/Ctrl + B`. </Step> <Step title="Drag Cline Icon"> Drag the Cline icon over to the nav panel at the top of that right view. </Step> </Steps><Frame>
</Frame>
<Frame>
</Frame>
Sometimes Cline doesn't show up in search results if you're looking in the wrong tab or using an incompatible IDE version. Make sure you're searching in the Marketplace tab (not Installed), try searching for "Cline AI" instead, and verify your IDE is up to date. If installation fails, restart your IDE and check your internet connection.
The most common fix is a full restart-close your IDE completely (File → Exit) and reopen it. In VS Code/Cursor/VSCodium, you can also open the Command Palette (Ctrl/Cmd + Shift + P) and type "Cline: Open In New Tab". In JetBrains, check View → Tool Windows → Cline. If it's still missing, verify the plugin is enabled in your Extensions/Plugins settings.
Cline CLI requires Node.js 20 or higher. Run node --version to check-if you need to upgrade, use nvm (nvm install 22 && nvm use 22) or download from nodejs.org. For permission errors on npm install -g, either prefix with sudo on macOS/Linux or configure npm to use a user-owned directory for global packages.
If Cline appears installed but doesn't respond, try disabling and re-enabling the extension in your IDE's settings. Check the Developer Console (VS Code: Help → Toggle Developer Tools) or Event Log (JetBrains) for error messages. Also ensure you're using a supported IDE version and close any resource-intensive extensions that might interfere.