Autonomous coding agent right in your IDE, capable of creating/editing files, executing commands, using the browser, and more with your permission every step of the way.

Tomás Barreiro a0faf7c677 Fix action injection risk (#10230) 8 hours ago
.agents 091cf945e4 Move PR skill to .agents/skills (#9505) 1 month ago
.claude f1a84ddbde feat: add Claude Code web session setup with gh CLI and worktree support (#8249) 3 months ago
.clinerules b3fc79b8ce Remove example hooks (#9896) 3 weeks ago
.codex f32dde2c16 chore: update codex environment config 1 month ago
.github a0faf7c677 Fix action injection risk (#10230) 8 hours ago
.husky 60ddf80e5c Remove --no-stash flag from lint-staged in pre-commit hook (#6188) 6 months ago
.vscode 01547ba1f4 feat: add AgentConfigLoader for file-based agent configs (ENG-1547) (#9245) 1 month ago
assets 2f33f71ebd Add lazy teammate mode (#10081) 1 week ago
cli 71d795eec8 Changelog and version bump for release (#10227) 9 hours ago
docs 034c4342d1 Complete documentation for environment variable-based OpenTelemetry configs (#10155) 4 days ago
evals 1dcf356f98 Remove old evals tool (#10226) 8 hours ago
locales c4c8b16afb chore: remove changesets bot artifacts (#9739) 1 month ago
proto 10197b038d feat(chat): add SpendLimitError UI for SPEND_LIMIT_EXCEEDED (429) (#10207) 1 day ago
scripts c09705a45f Add Linux ARM64 (aarch64) support for JetBrains plugin (#10062) 1 week ago
src 10197b038d feat(chat): add SpendLimitError UI for SPEND_LIMIT_EXCEEDED (429) (#10207) 1 day ago
standalone 8813f8252c Fix local CLI install to rebuild cleanly (#8653) 2 months ago
testing-platform 0ff27591d5 chore(deps-dev): bump lodash (#8803) 3 weeks ago
tests 072e2887b0 fix(cli): add --tui flag to TUI e2e tests to bypass Kanban redirect 2 weeks ago
walkthrough 47899ac52d Adding Cline Walkthrough (#3746) 10 months ago
webview-ui 10197b038d feat(chat): add SpendLimitError UI for SPEND_LIMIT_EXCEEDED (429) (#10207) 1 day ago
.env.example 4f1be9d512 Replace `POSTHOG_TELEMETRY_ENABLED` with `CLINE_TELEMETRY_DISABLED` (#8818) 2 months ago
.gitattributes 0c880c7bb1 fix: Serve H.264/MP4 for VSCode and VP9/WebM for JetBrains (#10012) 2 weeks ago
.gitignore a27bedffb6 max/cli tui e2e tests (#9753) 4 weeks ago
.gitmodules 3899469d76 feat(evals): comprehensive LLM evaluation framework with CI (#8909) 1 month ago
.mocharc.json 03211f1364 feat(sdk): add fetchFeaturebaseToken method [ENG-1673] (#10005) 1 week ago
.nvmrc fafdfe30a4 Add .nvmrc, .prettierignore, icon; Remove vsc quickstart guide 1 year ago
.nycrc.unit.json dfc660e73c Setup QLTY Initial Coverage Metrics (#6167) 6 months ago
.vscode-test.mjs b6f6358d4a Set up E2E tests with Playwright (#4721) 8 months ago
.vscodeignore 93eb607e6d Remove all traces of changeset-converter.yml GitHub Action and npm run changeset (#9506) 1 month ago
.worktreeinclude f1a84ddbde feat: add Claude Code web session setup with gh CLI and worktree support (#8249) 3 months ago
CHANGELOG.md 71d795eec8 Changelog and version bump for release (#10227) 9 hours ago
CLAUDE.md 6cff60b53b feat(cli): add TypeScript CLI (#9021) 2 months ago
CODE_OF_CONDUCT.md 860d315d7d Fix formatting 1 year ago
CONTRIBUTING.md 93eb607e6d Remove all traces of changeset-converter.yml GitHub Action and npm run changeset (#9506) 1 month ago
LICENSE 59c05f4b84 Update copyright year to 2026 2 months ago
README.md 5d6424682f Update README.md 2 months ago
SECURITY.md 792b9e89a1 update security policy to include bugcrowd vdp (#10117) 11 hours ago
biome.jsonc 095ee24288 Limit the CLI provider list to what's remotely configured (#9135) 2 months ago
buf.yaml a1bf1f95a3 refactor(proto): Align proto directory structure with package names to follow best practices (#5171) 8 months ago
esbuild.mjs 4f1be9d512 Replace `POSTHOG_TELEMETRY_ENABLED` with `CLINE_TELEMETRY_DISABLED` (#8818) 2 months ago
go.work.sum f47d07784a clean exits (#6886) 5 months ago
knip.json 1997ee3e80 refactor to hostbridge: route @mentions search via WorkspaceService.searchWorkspaceItems (#5655) 7 months ago
package-lock.json 71d795eec8 Changelog and version bump for release (#10227) 9 hours ago
package.json 71d795eec8 Changelog and version bump for release (#10227) 9 hours ago
playwright.config.ts 627838243e fix(e2e): increase test timeout for Windows CI runners (#9185) 2 months ago
test-setup.js 803574e7f3 move api folder to core (#5539) 7 months ago
tsconfig.json ea65383e16 chore: replace baseUrl with explicit relative paths in tsconfig files (#9508) 1 month ago
tsconfig.test.json 3210c4bc4b Rules: Add `paths:` conditional logic (don't wire it up yet) [ENG-1469] (#8648) 2 months ago
tsconfig.unit-test.json 3210c4bc4b Rules: Add `paths:` conditional logic (don't wire it up yet) [ENG-1469] (#8648) 2 months ago

README.md

Cline

Meet Cline, an AI assistant that can use your CLI aNd Editor.

Thanks to Claude Sonnet's agentic coding capabilities, Cline can handle complex software development tasks step-by-step. With tools that let him create & edit files, explore large projects, use the browser, and execute terminal commands (after you grant permission), he can assist you in ways that go beyond code completion or tech support. Cline can even use the Model Context Protocol (MCP) to create new tools and extend his own capabilities. While autonomous AI scripts traditionally run in sandboxed environments, this extension provides a human-in-the-loop GUI to approve every file change and terminal command, providing a safe and accessible way to explore the potential of agentic AI.

  1. Enter your task and add images to convert mockups into functional apps or fix bugs with screenshots.
  2. Cline starts by analyzing your file structure & source code ASTs, running regex searches, and reading relevant files to get up to speed in existing projects. By carefully managing what information is added to context, Cline can provide valuable assistance even for large, complex projects without overwhelming the context window.
  3. Once Cline has the information he needs, he can:
    • Create and edit files + monitor linter/compiler errors along the way, letting him proactively fix issues like missing imports and syntax errors on his own.
    • Execute commands directly in your terminal and monitor their output as he works, letting him e.g., react to dev server issues after editing a file.
    • For web development tasks, Cline can launch the site in a headless browser, click, type, scroll, and capture screenshots + console logs, allowing him to fix runtime errors and visual bugs.
  4. When a task is completed, Cline will present the result to you with a terminal command like open -a "Google Chrome" index.html, which you run with a click of a button.

[!TIP] Follow this guide to open Cline on the right side of your editor. This lets you use Cline side-by-side with your file explorer, and see how he changes your workspace more clearly.


Use any API and Model

Cline supports API providers like OpenRouter, Anthropic, OpenAI, Google Gemini, AWS Bedrock, Azure, GCP Vertex, Cerebras and Groq. You can also configure any OpenAI compatible API, or use a local model through LM Studio/Ollama. If you're using OpenRouter, the extension fetches their latest model list, allowing you to use the newest models as soon as they're available.

The extension also keeps track of total tokens and API usage cost for the entire task loop and individual requests, keeping you informed of spend every step of the way.


Run Commands in Terminal

Thanks to the new shell integration updates in VSCode v1.93, Cline can execute commands directly in your terminal and receive the output. This allows him to perform a wide range of tasks, from installing packages and running build scripts to deploying applications, managing databases, and executing tests, all while adapting to your dev environment & toolchain to get the job done right.

For long running processes like dev servers, use the "Proceed While Running" button to let Cline continue in the task while the command runs in the background. As Cline works he’ll be notified of any new terminal output along the way, letting him react to issues that may come up, such as compile-time errors when editing files.


Create and Edit Files

Cline can create and edit files directly in your editor, presenting you a diff view of the changes. You can edit or revert Cline's changes directly in the diff view editor, or provide feedback in chat until you're satisfied with the result. Cline also monitors linter/compiler errors (missing imports, syntax errors, etc.) so he can fix issues that come up along the way on his own.

All changes made by Cline are recorded in your file's Timeline, providing an easy way to track and revert modifications if needed.


Use the Browser

With Claude Sonnet's new Computer Use capability, Cline can launch a browser, click elements, type text, and scroll, capturing screenshots and console logs at each step. This allows for interactive debugging, end-to-end testing, and even general web use! This gives him autonomy to fixing visual bugs and runtime issues without you needing to handhold and copy-pasting error logs yourself.

Try asking Cline to "test the app", and watch as he runs a command like npm run dev, launches your locally running dev server in a browser, and performs a series of tests to confirm that everything works. See a demo here.


"add a tool that..."

Thanks to the Model Context Protocol, Cline can extend his capabilities through custom tools. While you can use community-made servers, Cline can instead create and install tools tailored to your specific workflow. Just ask Cline to "add a tool" and he will handle everything, from creating a new MCP server to installing it into the extension. These custom tools then become part of Cline's toolkit, ready to use in future tasks.

  • "add a tool that fetches Jira tickets": Retrieve ticket ACs and put Cline to work
  • "add a tool that manages AWS EC2s": Check server metrics and scale instances up or down
  • "add a tool that pulls the latest PagerDuty incidents": Fetch details and ask Cline to fix bugs


Add Context

@url: Paste in a URL for the extension to fetch and convert to markdown, useful when you want to give Cline the latest docs

@problems: Add workspace errors and warnings ('Problems' panel) for Cline to fix

@file: Adds a file's contents so you don't have to waste API requests approving read file (+ type to search files)

@folder: Adds folder's files all at once to speed up your workflow even more


Checkpoints: Compare and Restore

As Cline works through a task, the extension takes a snapshot of your workspace at each step. You can use the 'Compare' button to see a diff between the snapshot and your current workspace, and the 'Restore' button to roll back to that point.

For example, when working with a local web server, you can use 'Restore Workspace Only' to quickly test different versions of your app, then use 'Restore Task and Workspace' when you find the version you want to continue building from. This lets you safely explore different approaches without losing progress.


Contributing

To contribute to the project, start with our Contributing Guide to learn the basics. You can also join our Discord to chat with other contributors in the #contributors channel. If you're looking for full-time work, check out our open positions on our careers page!

Enterprise

Get the same Cline experience with enterprise-grade controls: SSO (SAML/OIDC), global policies and configuration, observability with audit trails, private networking (VPC/private link), and self-hosted or on-prem deployments, and enterprise support. Learn more at our enterprise page or talk to us.

License

Apache 2.0 © 2026 Cline Bot Inc.