Files
cline/docs/getting-started/installing-cline.mdx
Renee Huang 252082b9e9 docs: surface Cline Desktop and reorder overview sections (#14572)
Reorganize the Cline Overview page and add Cline Desktop to the
install docs.

cline-overview.mdx:
- Move Applications above Model access, so the page leads with
  "what do I install" before "how do I pay".
- Add Cline Desktop App as the first application card, linking
  directly to the cline.bot download.
- Merge the SDK into the Applications grid as its final card and
  drop the standalone "Agent Core (SDK)" section, leaving a clean
  2x3 grid with no orphan row.
- Reword the Applications intro, which claimed every entry was
  "built on top of Cline's agent core" -- no longer true once the
  core itself is listed.

installing-cline.mdx:
- Add a Desktop App install path as the first option, covering
  download, workspace/branch selection, model choice, and sessions.
- Link both the Desktop and Desktop SSH pages.

Also fixes an invisible icon: the Font Awesome "monitor" icon used
for the desktop card returns 403 from the CDN, so the card rendered
with no glyph at all. Switched to "desktop", which resolves. All 13
icons on the overview page were verified against the CDN.
2026-09-26 21:50:57 -07:00

159 lines
4.4 KiB
Plaintext

---
title: "Installing Cline"
description: "Choose your installation path: IDE Extension, CLI, SDK, or Kanban"
---
## Choose Your Install Path
- [Desktop App](#desktop-app) — Cline as a native app
- [IDE Extension](#ide-extension) — VS Code, Cursor, JetBrains, Windsurf, VSCodium, Antigravity
- [CLI](#cli) — terminal workflows
- [Kanban](#kanban) (preview) — easily manage multiple agents through a kanban board
- [SDK](#sdk) — build with `@cline/sdk`
## Desktop App
Use this if you want Cline outside your editor, as a native desktop app with a dedicated workspace for running and managing agent sessions.
<Steps>
<Step title="Download Cline Desktop">
Get the installer for your platform from [cline.bot/desktop](https://cline.bot/desktop). Available for macOS and Windows (Windows is currently in beta).
</Step>
<Step title="Choose a provider and model">
Select the provider and open weight model of your choice. Cline Desktop is an open source app for open weight models, so you bring your own model access.
</Step>
<Step title="Start a session">
Run sessions in parallel, schedule recurring tasks, and import sessions from other coding agents to continue in Cline.
</Step>
</Steps>
More details: [Cline Desktop](/usage/cline-desktop), and for remote machines [Cline Desktop SSH](/usage/cline-desktop-ssh)
## IDE Extension
Use this if you want Cline inside your editor UI.
<Tabs>
<Tab title="VS Code / Cursor / Windsurf / VSCodium / Antigravity">
<Steps>
<Step title="Open Extensions">
Press `Ctrl/Cmd + Shift + X`.
</Step>
<Step title="Search for Cline">
Type `Cline`.
</Step>
<Step title="Install">
Click **Install** on the Cline extension.
</Step>
<Step title="Open Cline">
Find Cline in the extension sidebar.
</Step>
<Step title="Authorize with Cline">
After installing the extension, complete provider setup in Cline settings. Use the Cline Provider for pay-as-you-go access, ClinePass for a flat monthly subscription, or bring your own provider key.
[Authorize with Cline](/getting-started/authorizing-with-cline)
</Step>
</Steps>
<Note>
Windsurf and VSCodium use Open VSX. The install flow is the same.
</Note>
</Tab>
<Tab title="JetBrains">
<Steps>
<Step title="Open Plugins Marketplace">
**Settings** → **Plugins** → **Marketplace**.
</Step>
<Step title="Install Cline">
Search `Cline`, click **Install**, then restart the IDE.
</Step>
<Step title="Open Cline">
**View** → **Tool Windows** → **Cline**.
</Step>
<Step title="Authorize with Cline">
After installing the extension, complete provider setup in Cline settings. Use the Cline Provider for pay-as-you-go access, ClinePass for a flat monthly subscription, or bring your own provider key.
[Authorize with Cline](/getting-started/authorizing-with-cline)
</Step>
</Steps>
Alternative: install from the [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/28247-cline).
</Tab>
</Tabs>
## CLI
Use this if you want Cline in terminal workflows (interactive + automation).
<Steps>
<Step title="Install Node.js">
Install Node.js 20+ (22 recommended).
</Step>
<Step title="Install CLI">
```bash
npm install -g cline
```
</Step>
<Step title="Authenticate">
```bash
cline auth
```
</Step>
<Step title="Run Cline">
```bash
cline
# or
cline "your task"
```
</Step>
</Steps>
More details: [CLI Installation & Setup](/usage/cli-overview)
## Kanban
Use this if you want task-board workflows with agent execution.
<Steps>
<Step title="Install Node.js">
Install Node.js 18+.
</Step>
<Step title="Launch Kanban">
```bash
npx kanban
```
</Step>
</Steps>
More details: [Kanban](/usage/kanban)
## SDK
Use this if you are building your own app/agent on top of Cline.
<Steps>
<Step title="Create project">
```bash
mkdir my-agent && cd my-agent
npm init -y
```
</Step>
<Step title="Install SDK">
```bash
npm install @cline/sdk
```
</Step>
<Step title="Build and run">
Browse SDK examples to run your first agent.
</Step>
</Steps>
Start here: [SDK Examples](/sdk/examples)
## Need Help?
- [Troubleshooting](/troubleshooting/networking-and-proxies)
- [Discord community](https://discord.gg/cline)