README

Cline


The open source coding agent in your IDE, terminal, & desktop!








Docs


Discord


r/cline


Feature Requests


Join us!














 CLI

Run Cline in your terminal.
Interactive chat or fully headless 
for CI/CD and scripting.


npm i -g cline


Learn more





 Desktop App

Cline as a native app for macOS and Windows.
Run agent sessions in any folder, schedule
routines, and manage models, plugins, and MCP servers.

Download for macOS and Windows







 VS Code Extension

AI coding assistant in your editor.
Create files, run commands, browse the web,
and use tools with human-in-the-loop approval.

Install from VS Marketplace





 JetBrains Plugin

The same Cline experience in IntelliJ IDEA,
PyCharm, WebStorm, GoLand, and the rest of
the JetBrains family.

Install from JetBrains Marketplace












 SDK

Build your own AI agents and integrations powered by the same engine that runs the CLI, desktop app, VS Code extension, and JetBrains plugin. Custom tools, multi-agent teams, connectors, scheduled automations, and more.


npm install @cline/sdk


Documentation







---

 Index

| Product | Description | Location | CHANGELOG |
|---------|------------|--------------|--------------|
| SDK | Node.js programmatic agent API and extension exports. | sdk/ | CHANGELOG.md |
| CLI | Terminal UI, headless mode, shell commands, and CLI-specific flows. | apps/cli/ | CHANGELOG.md |
| VS Code Extension | The Marketplace extension and extension host integration. | apps/vscode/ | CHANGELOG.md |
| Desktop App | Native macOS and Windows app (Tauri shell, Bun sidecar, Next.js UI). | apps/examples/desktop-app/ | CHANGELOG.md |
| JetBrains Plugin | JetBrains-hosted client that talks to the shared agent core. | Currently we are not open-sourcing JetBrains plugins | - |
| Docs site | Public documentation pages. | docs/ | - |

 Edits Code Across Your Project

Cline reads your project structure, understands the relationships between files, and makes coordinated changes across your codebase. It monitors linter and compiler errors as it works, fixing issues like missing imports, type mismatches, and syntax errors before you even see them. In VS Code and JetBrains, every edit shows up as a diff you can review, modify, or revert. All changes are tracked with checkpoints, so you can easily undo the agent's work.

 Runs Bash Commands

Cline executes commands directly in your terminal and watches the output in real time. Install packages, run build scripts, execute tests, deploy applications, manage databases. For long-running processes like dev servers, Cline continues working in the background and reacts to new output as it appears, catching compile errors, test failures, and server crashes as they happen.

 Plan and Act

Toggle between Plan mode and Act mode. In Plan mode, Cline explores your codebase, asks clarifying questions, and lays out a strategy. Once you're aligned, switch to Act mode and Cline executes the plan. Every file edit and terminal comm

Top issues

Discussions

Latest release

Added

- Cloud tasks: Settings  API Configuration has a Local | Cloud toggle when cloud sessions are on. Cloud picks the Cline model new cloud tasks run on, saved separately from your local models. Clicking the model label in a cloud session's composer opens it there.
- Starting or resuming a cloud sandbox shows a progress card with the repo, branch and steps (start sandbox, clone repository, start agent). It collapses once the agent starts.

 Changed

- Cloud sessions hide the Plan/Act toggle and the auto-approve bar instead of showing them disabled.
- With no model chosen, the Cline provider