mirror of https://github.com/cline/cline.git synced 2026-09-01 15:11:04 +08:00

Files

T

Tomás Barreiro 220a21bdcf Move sdk/apps/ to apps/ (#11200 )

* Move the apps to the root dir

* Update all references from sdk/apps/ to apps/

* Update dependencies

* Install bun types

* Fix types

* Fix types

* Fix linter

* Ingore apps from vscode

* Fix security warning

* Fix windows install

* Enable windows dev mode

* Revert "Enable windows dev mode"

This reverts commit a46c99282e.

* Revert "Ingore apps from vscode"

This reverts commit 47f7b265d2.

* Revert "Fix windows install"

This reverts commit 1dabba1556.

* update the repo root

* fix root dir

* fix path

* fix other path

* Fix unrelated changes

* fix: address apps move follow-up blockers (#11228)

* fix: update root app command paths

* fix: include moved apps in root checks

* fix: clean up moved app path references

---------

Co-authored-by: Saoud Rizwan <7799382+saoudrizwan@users.noreply.github.com>

2026-06-03 01:49:57 +02:00

2.9 KiB

Raw Blame History

Cline SDK Examples

Learn how to build with the Cline SDK through working examples, ordered from simple to complex.

SDK Skill

If you use a coding agent (Claude Code, Codex, Cline, etc.), install the Cline SDK skill to give your agent context on the SDK's APIs and best practices to help you build with the Cline SDK.

npx skills add cline/sdk-skill

Prompt it to scaffold agents, create custom tools, wire up plugins, configure providers, and more.

Getting started

All examples live in this directory. Each is a standalone project with its own package.json and README. To run any example:

cd apps/examples/<example-name>
bun install
bun run build:sdk
export CLINE_API_KEY="cline_..."
bun dev

Requires Node.js 22+.

Examples

Beginner

Example	Description	Concepts
quickstart	Send one prompt, stream the response. ~15 lines of code.	`Agent`, `subscribe`, `run()`
cli-agent	Interactive terminal chat with a shell tool.	`createTool`, multi-turn `run()`/`continue()`, streaming
cline-core-cli-agent	Interactive terminal chat powered by ClineCore.	`ClineCore.create()`, `cline.start()`, `cline.send()`, built-in tools, streaming

Intermediate

Example	Description	Concepts
code-review-bot	AI code reviewer that reads git diffs and produces structured comments.	Multiple tools, `completesRun` lifecycle, `systemPrompt`, zod schemas
multi-agent	Web app that fans out to three specialist agents in parallel, streams results via SSE, then synthesizes a unified answer.	Concurrent agents, `Promise.all`, per-agent `subscribe()`, SSE streaming, agent composition

Advanced

Example	Description	Concepts
desktop-app	Full Tauri + Next.js desktop app for running and inspecting chat sessions.	Sidecar runtime, websocket transport, session persistence
menubar	macOS menu bar app with Tauri.	Native app integration, compact UI
vscode	VS Code extension with chat panel.	Extension API, webview, workspace context

SDK packages

When building your own app, install the public SDK package:

npm add @cline/sdk

@cline/sdk re-exports everything from @cline/core. You only need @cline/agents or @cline/llms if you want lower-level control over the agent runtime or model gateway directly.

Learn more

SDK package docs
Architecture guide
Plugin examples - extend the Cline SDK and CLI with custom tools and event hooks
Hook examples - lifecycle hooks for logging, blocking, and injection for Cline SDK and CLI

2.9 KiB Raw Blame History