Back to Cline

README

README.md

3.83.08.4 KB
Original Source
<p align="center"> </p> <h1 align="center">Cline</h1> <p align="center"> The open source coding agent in your IDE and terminal. </p> <div align="center"> <div align="center"> <table> <tbody> <td align="center"> <a href="https://docs.cline.bot" target="_blank"><strong>Docs</strong></a> </td> <td align="center"> <a href="https://discord.gg/cline" target="_blank"><strong>Discord</strong></a> </td> <td align="center"> <a href="https://www.reddit.com/r/cline/" target="_blank"><strong>r/cline</strong></a> </td> <td align="center"> <a href="https://github.com/cline/cline/discussions/categories/feature-requests?discussions_q=is%3Aopen+category%3A%22Feature+Requests%22+sort%3Atop" target="_blank"><strong>Feature Requests</strong></a> </td> <td align="center"> <a href="https://cline.bot/join-us" target="_blank"><strong>Join us!</strong></a> </td> </tbody> </table> </div> </div> <div align="center"> <table> <tr> <td align="center" width="50%">

CLI

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

npm i -g cline

<a href="./sdk/apps/cli/README.md">Learn more</a>

</td> <td align="center" width="50%">

Kanban

Run many agents in parallel from a web-based task board. Each card gets its own worktree, auto-commit, and dependency chains.

npm i -g kanban

<a href="https://github.com/cline/kanban">Learn more</a>

</td> </tr> <tr> <td align="center" width="50%">

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.

<a href="https://marketplace.visualstudio.com/items?itemName=saoudrizwan.claude-dev">Install from VS Marketplace</a>

</td> <td align="center" width="50%">

JetBrains Plugin

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

<a href="https://plugins.jetbrains.com/plugin/28247-cline">Install from JetBrains Marketplace</a>

</td> </tr> </table> </div> <div align="center"> <table> <tr> <td align="center">

SDK

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

npm install @cline/sdk

<a href="https://docs.cline.bot/cline-sdk/overview">Documentation</a>

</td> </tr> </table> </div>

Index

ProductDescriptionLocation
SDKNode.js programmatic agent API and extension exports.sdk/
CLITerminal UI, headless mode, shell commands, and CLI-specific flows.sdk/apps/cli/
VS Code ExtensionThe Marketplace extension and extension host integration./ (WIP migrating)
JetBrains PluginJetBrains-hosted client that talks to the shared agent core.Currently we are not open-sourcing JetBrains plugins
KanbanWeb-based multi-agent task board.cline/kanban.
Docs sitePublic 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 command requires your approval, so you stay in control of what actually changes. Or toggle auto-approve and let Cline run autonomously.

Rules and Skills

Define project-specific rules in .clinerules files that guide how Cline works in your codebase: coding standards, architecture conventions, deployment procedures, testing requirements. Rules are picked up automatically by the CLI, VS Code extension, and JetBrains plugin. Use skills to let the model load specific rules when needed.

Works With Every Model

Cline is not locked to a single AI provider. Use whichever model fits your workflow:

ProviderModels
AnthropicClaude Opus, Sonnet, Haiku
OpenAIGPT series model
GoogleGemini series model
OpenRouter200+ models from any provider
Vercel AI GatewayModels through Vercel AI Gateway
AWS BedrockClaude, Llama, and more
Azure / GCP VertexAll hosted models
Cerebras / GroqFast inference models
Ollama / LM StudioRun local models on your machine
Any OpenAI-compatible APISelf-hosted or third-party endpoints

Extend With Plugins or MCP Servers

Extend Cline's capabilities with plugins. Using the SDK, register tools and lifecycle hooks programmatically through the plugin system for logging, auditing, policy enforcement, or adding domain-specific capabilities. Simple plugin example below.

typescript
import { Agent, createTool } from "@cline/sdk"

const deployTool = createTool({
  name: "deploy",
  description: "Deploy the current branch to staging.",
  inputSchema: { type: "object", properties: { env: { type: "string" } }, required: ["env"] },
  execute: async (input) => {
    // your deployment logic
  },
})

const agent = new Agent({ tools: [deployTool], /* ... */ })

...or use MCP servers to connect to databases, query APIs, manage cloud infrastructure, and interact with external systems. Use community-built servers or ask Cline to create custom tools on the fly. In the CLI, manage servers with cline mcp.

Multi-Agent Teams

Coordinate multiple agents working together on complex tasks. A coordinator agent breaks the work into subtasks and delegates to specialist agents, each with their own tools and context. Team state persists across sessions so you can pick up where you left off.

bash
cline --team-name auth-sprint "Plan and implement user authentication with tests"

Scheduled Agents

Run agents on cron schedules for recurring automations. Daily PR summaries, weekly dependency checks, codebase health reports. Schedules persist across restarts and run independently of any terminal session.

bash
cline schedule create "PR summary" \
  --cron "0 9 * * MON-FRI" \
  --prompt "List all open PRs and their review status" \
  --workspace /path/to/repo

Connect to Slack, Telegram, Discord, and More

Chat with your agent from any messaging platform: Telegram, Slack, Discord, Google Chat, WhatsApp, and Linear. Each conversation thread maps to an agent session with full context. Set up access control to restrict who can interact with your agent.

bash
cline connect telegram -m my_bot -k $BOT_TOKEN
cline connect slack --token $SLACK_TOKEN --signing-secret $SECRET --base-url $URL

Headless CLI for CI/CD

Run Cline with zero interaction for scripting and automation. Pipe input, get JSON output, chain commands, integrate into CI/CD pipelines.

bash
cline "Run tests and fix any failures"
git diff origin/main | cline  "Review these changes for issues"
cline --json "List all TODO comments" | jq -r 'select(.type == "agent_event" and .event.text) | .event.text'

Contributing

Start with the Contributing Guide. Join our Discord and head to the #contributors channel to connect with other contributors. Check our careers page for full-time roles.

License

Apache 2.0 © 2026 Cline Bot Inc.