Installing Cline

Before You Begin

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.

Installation Instructions

VS Code/Cursor/Antigravity
JetBrains IDEs
CLI
Zed/Neovim (ACP via CLI)
VSCodium/Windsurf

Open VS Code, Cursor, or Antigravity

Launch the editor on your computer.

Open Extensions

Press Ctrl/Cmd + Shift + X or click the Extensions icon in the Activity Bar.

Search for Cline

Type “Cline” in the search bar.

Install

Click the Install button on the Cline extension.

Access Cline

Click the Cline icon in the Activity Bar, or open Command Palette (Ctrl/Cmd + Shift + P) and type “Cline: Open In New Tab”.

If VS Code shows “Running extensions might…” dialog, click Allow. If you don’t see the Cline icon, restart VS Code.

Cline for JetBrains works almost identically to VS Code, with all core features: diff editing, tools, multiple API providers, MCP servers, Cline rules/workflows, and more.

Open your JetBrains IDE

Launch IntelliJ IDEA, PyCharm, WebStorm, or any JetBrains IDE.

Open Settings

Press Ctrl+Alt+S (Windows/Linux) or Cmd+, (macOS).

Navigate to Plugins

Go to Plugins → Marketplace tab.

Install Cline

Search for “Cline” and click Install.

Restart IDE

Restart your IDE to complete the installation.

Find Cline in View → Tool Windows → Cline (usually on the right side).

Alternative Installation Methods

Browser Install:

Go to the JetBrains Marketplace
Click Install to IDE
Confirm in your IDE and restart

Manual Install:

Download from the marketplace page
Go to Settings → Plugins → gear icon → Install Plugin from Disk
Select the downloaded .zip file and restart

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.

Preview Release: Cline CLI is currently in preview and only available for macOS and Linux. Windows support is coming soon.

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.

Install Node.js 20+

Check your version with node --version. If needed, visit nodejs.org or use nvm.

Install Cline CLI

Run npm install -g cline in your terminal.

Authenticate

Run cline auth to sign in and configure your AI model provider.

Run Cline

Run cline to start an interactive session, or cline "Your task here" for headless execution.

Want to learn more? See the Cline CLI documentation for advanced usage patterns like multi-instance development and CI/CD integration.

ACP (Agent Client Protocol) lets you run Cline in any ACP-compatible editor via the CLI. This gives you full access to Cline’s capabilities—including Skills, Hooks, and MCP integrations—in your preferred editor.

Install Node.js 20+

Check your version with node --version. If needed, visit nodejs.org or use nvm.

Install Cline CLI

npm install -g cline

Authenticate

cline auth

Configure your editor

Zed
Neovim (agentic.nvim)
Neovim (avante.nvim)

Open Zed settings (Cmd/Ctrl + ,) and add Cline to your settings.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.

Install agentic.nvim using lazy.nvim:

{
  "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.

Follow the avante.nvim documentation for configuring external ACP agents and point it to cline --acp.

For full details on ACP editor integrations—including JetBrains ACP setup and troubleshooting—see the ACP Editor Integrations guide.

These editors use the Open VSX Registry instead of the VS Code Marketplace, but the installation process is nearly identical.

Open your editor

Launch VSCodium, Windsurf, or another Open VSX-compatible editor.

Open Extensions

Press Ctrl/Cmd + Shift + X.

Search for Cline

Type “Cline” in the search bar.

Install

Select “Cline” by saoudrizwan and click Install.

Reload

Reload your editor if prompted.

Look for the Cline icon in your Activity Bar or use the Command Palette.

CLI users: If you installed via CLI, you already authenticated during setup with cline auth. You’re ready to go!

Open Cline in your editor:
- VS Code/Cursor/Antigravity/VSCodium/Windsurf: Click the Cline icon in the Activity Bar
- JetBrains: Go to View → Tool Windows → Cline
Sign in by clicking the Sign Up button in the Cline interface. You’ll be redirected to app.cline.bot to authenticate.
Learn more about authorizing with Cline, including how OAuth authentication works, using API keys with other providers, and troubleshooting auth issues.
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.

VS Code
Cursor

Align Extension View

Make sure your extension view is aligned vertically to the left.

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.

Drag Cline Icon

Drag the Cline icon over to the nav panel at the top of that right view.

Set Vertical Activity Bar

Cursor uses a horizontal activity bar by default. To switch to vertical:

Open Command Palette (Cmd/Ctrl + Shift + P)
Search for “Preferences: Open Settings (UI)”
Search for workbench.activityBar.orientation
Set the value to vertical
Restart Cursor

Open the AI Pane

Click the Cursor cube icon (AI Pane) to open the right side view panel.

Drag Cline to the AI Pane

Drag the Cline icon directly into the AI Pane sidebar.

Troubleshooting

Can’t Find Cline in the Marketplace

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.

Cline Icon Not Appearing After Install

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.

CLI: Node.js or Permission Errors

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.

Plugin Installed But Not Working

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.

Need Help?

Join our Discord community for support, tips, and discussions.
Read the docs to explore model selection guides and advanced features.

Home

Getting Started

Core Workflows

Customization

Cline CLI

Features

Models & Providers

MCP (Extending Cline)

Tools Reference

Troubleshooting

Contributing

Installing Cline

Before You Begin

Installation Instructions

Setting Up Cline in the Right Sidebar

Troubleshooting

Can’t Find Cline in the Marketplace

Cline Icon Not Appearing After Install

CLI: Node.js or Permission Errors

Plugin Installed But Not Working

Need Help?

Home

Getting Started

Core Workflows

Customization

Cline CLI

Features

Models & Providers

MCP (Extending Cline)

Tools Reference

Troubleshooting

Contributing

​Before You Begin

​Installation Instructions

​Sign In & Start Building

​Setting Up Cline in the Right Sidebar

​Troubleshooting

​Can’t Find Cline in the Marketplace

​Cline Icon Not Appearing After Install

​CLI: Node.js or Permission Errors

​Plugin Installed But Not Working

​Need Help?

Before You Begin

Installation Instructions

Sign In & Start Building

Setting Up Cline in the Right Sidebar

Troubleshooting

Can’t Find Cline in the Marketplace

Cline Icon Not Appearing After Install

CLI: Node.js or Permission Errors

Plugin Installed But Not Working

Need Help?