[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-cline-cline-sdk":3,"mdc-f20fo7-key":36,"related-repo-cline-cline-sdk":1665,"related-org-cline-cline-sdk":1675},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"cline-sdk","build AI agents with Cline SDK","Comprehensive Cline SDK skill for building AI agents. Covers the direct Agent runtime, ClineCore sessions, custom tools, plugins, events, LLM providers, scheduling, multi-agent teams, and production deployment. Use for any task involving @cline\u002Fsdk or its sub-packages.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"cline","Cline","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fcline.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Agents","agents","tag",{"name":17,"slug":18,"type":15},"Engineering","engineering",{"name":20,"slug":21,"type":15},"SDK","sdk",{"name":23,"slug":24,"type":15},"Multi-Agent","multi-agent",7,"https:\u002F\u002Fgithub.com\u002Fcline\u002Fsdk-skill","2026-07-12T08:14:03.160345",null,3,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"@cline\u002Fsdk skill","https:\u002F\u002Fgithub.com\u002Fcline\u002Fsdk-skill\u002Ftree\u002FHEAD\u002Fskill\u002Fcline-sdk","---\nname: cline-sdk\ndescription: Comprehensive Cline SDK skill for building AI agents. Covers the direct Agent runtime, ClineCore sessions, custom tools, plugins, events, LLM providers, scheduling, multi-agent teams, and production deployment. Use for any task involving @cline\u002Fsdk or its sub-packages.\nmetadata:\n   references: agent, clinecore\n---\n\n# Cline SDK Skill\n\nConsolidated skill for building AI agents with the Cline SDK. Use the decision trees below to find the right entry point and API surface, then load detailed references.\n\n## Critical Rules\n\nFollow these rules in all Cline SDK code:\n\n1. Install with `npm install @cline\u002Fsdk`. The `@cline\u002Fsdk` package re-exports `@cline\u002Fcore`, not every sub-package directly. Core re-exports the public SDK surface such as `ClineCore`, `Agent`, `createAgentRuntime`, `createTool`, built-in tool helpers, provider helpers, and the `Llms` namespace. Import from `@cline\u002Fagents`, `@cline\u002Fllms`, or `@cline\u002Fshared` only when you need APIs that core does not re-export, such as `AgentRuntime`, `createAgent`, or some low-level types.\n2. Requires Node.js 22 or later.\n3. Use `createTool()` from `@cline\u002Fsdk` (or `@cline\u002Fshared`) to define tools. Tool names must be `snake_case`.\n4. Prefer returning structured error data from tool `execute` functions when the agent can recover. Direct `Agent` converts thrown tool errors into error tool results; ClineCore can also count repeated failed tool turns toward its mistake-limit handling.\n5. Use `lifecycle: { completesRun: true }` on tools that should end the agent loop (e.g. a \"submit answer\" tool).\n6. When using `ClineCore`, always call `dispose()` when done to clean up resources.\n7. The direct `Agent` and `ClineCore` have different event systems. For `Agent`: use `agent.subscribe()` to get `AgentRuntimeEvent` types, text streaming is `\"assistant-text-delta\"`, and result text is `result.outputText`. For `ClineCore`: use `cline.subscribe()` to get `CoreSessionEvent` types. Render user-facing text, reasoning, and tool activity from `\"agent_event\"` payloads (`content_start`, `content_update`, `content_end`, `done`). Treat `\"chunk\"` events as raw transport chunks with `{ stream, chunk, ts }`, not as typed text deltas. `ClineCore` result text is `result.text`. There is no top-level `onEvent` field on `AgentRuntimeConfig`; use `agent.subscribe()` or `hooks.onEvent` instead. Do not use `\"content_update\"` or `\"content_start\"` with `agent.subscribe()`; those are host-facing `AgentEvent` types carried inside ClineCore `agent_event` events.\n8. For direct `Agent`, `plugins` are simple runtime plugins with `setup(context)` returning `{ tools, hooks }`. For `ClineCore`, `extensions` are `AgentPlugin` objects with `manifest`, `setup(api, ctx)`, and optional `hooks`. Do not use ClineCore plugin examples inside direct `Agent.plugins`.\n9. Plugin skills are **file-based**, not registered. There is no `registerSkill()` and no `api.registerSkill`. A plugin ships skills as `SKILL.md` files under `\u003Cpackage>\u002Fskills\u002F\u003Cname>\u002FSKILL.md` (package shape required); the host discovers them and surfaces them as `\u002Fslash-commands` automatically -- do not call `registerCommand` for skills. Plugin MCP servers use `api.registerMcpServer()` with the `\"mcp\"` capability. Configured agents (agent profiles) are YAML files in `.cline\u002Fagents\u002F` loaded as `subagent_\u003Cname>` tools when `enableSpawnAgent` is true.\n\n## How to Use This Skill\n\n### Reference File Structure\n\nThe two main API surfaces (`Agent` and `ClineCore`) follow a 4-file pattern. Cross-cutting concepts are single-file guides.\n\nEach main API surface in `.\u002Freferences\u002F\u003Capi>\u002F` contains:\n\n| File | Purpose | When to Read |\n|------|---------|--------------|\n| `REFERENCE.md` | Overview, when to use, quick start | Always read first |\n| `api.md` | Full API: classes, methods, config, types | Writing code |\n| `patterns.md` | Common patterns, best practices | Implementation guidance |\n| `gotchas.md` | Pitfalls, limitations, debugging | Troubleshooting |\n\nCross-cutting concepts in `.\u002Freferences\u002F\u003Cconcept>\u002F` have `REFERENCE.md` as the entry point.\n\n### Reading Order\n\n1. Start with `REFERENCE.md` for your chosen API surface\n2. Then read additional files relevant to your task:\n   - Writing agent code -> `api.md`\n   - Common patterns -> `patterns.md`\n   - Creating tools -> `tools\u002FREFERENCE.md`\n   - Adding plugins\u002Fhooks -> `plugins\u002FREFERENCE.md`\n   - Configuring LLM providers -> `providers\u002FREFERENCE.md`\n   - Streaming events -> `events\u002FREFERENCE.md`\n   - Deploying to production -> `production\u002FREFERENCE.md`\n   - Scheduling agents -> `scheduling\u002FREFERENCE.md`\n   - Multi-agent orchestration -> `multi-agent\u002FREFERENCE.md`\n   - Debugging -> `gotchas.md`\n\n### Example Paths\n\n```\n.\u002Freferences\u002Fagent\u002FREFERENCE.md           # Start here for lightweight agents\n.\u002Freferences\u002Fclinecore\u002FREFERENCE.md       # Start here for full runtime\n.\u002Freferences\u002Fagent\u002Fapi.md                 # Agent class, config, methods\n.\u002Freferences\u002Ftools\u002FREFERENCE.md           # Creating and using tools\n.\u002Freferences\u002Fplugins\u002FREFERENCE.md         # Plugin system\n.\u002Freferences\u002Fproviders\u002FREFERENCE.md       # LLM provider configuration\n```\n\n## Quick Decision Trees\n\n### \"Which API surface should I use?\"\n\n```\nWhich API?\n+-- I want a simple, in-memory agent with custom tools\n|   +-- agent\u002F (Agent class from @cline\u002Fagents, re-exported by @cline\u002Fsdk)\n+-- I need session persistence, built-in tools, config discovery\n|   +-- clinecore\u002F (ClineCore from @cline\u002Fcore)\n+-- I want built-in file\u002Fshell\u002Fsearch\u002Fweb tools\n|   +-- clinecore\u002F (has built-in tools; Agent does not)\n+-- I want scheduled or recurring agents\n|   +-- clinecore\u002F (automation API)\n+-- I need multi-process or multi-client session sharing\n|   +-- clinecore\u002F (hub-backed runtime)\n+-- I'm building a browser-compatible agent\n|   +-- agent\u002F (no Node.js dependencies)\n```\n\n### \"I need to create tools\"\n\n```\nTools?\n+-- Define a custom tool with schema -> tools\u002FREFERENCE.md\n+-- Use built-in tools (read_files, search_codebase, run_commands, etc.) -> tools\u002FREFERENCE.md (built-in section)\n+-- Control tool approval\u002Fpolicies -> tools\u002FREFERENCE.md (policies section)\n+-- Tool that ends the agent loop -> tools\u002FREFERENCE.md (completion tools)\n+-- Package tools as a reusable plugin -> plugins\u002FREFERENCE.md\n```\n\n### \"I need to handle events\"\n\n```\nEvents?\n+-- Stream text\u002Freasoning in real time -> events\u002FREFERENCE.md\n+-- Track token usage and costs -> events\u002FREFERENCE.md\n+-- Watch tool calls -> events\u002FREFERENCE.md\n+-- Detect completion\u002Ferrors -> events\u002FREFERENCE.md\n+-- Hook into lifecycle stages -> plugins\u002FREFERENCE.md\n```\n\n### \"I need to configure a model provider\"\n\n```\nProviders?\n+-- Anthropic (Claude) -> providers\u002FREFERENCE.md\n+-- OpenAI (GPT) -> providers\u002FREFERENCE.md\n+-- Google (Gemini\u002FVertex) -> providers\u002FREFERENCE.md\n+-- AWS Bedrock -> providers\u002FREFERENCE.md\n+-- Mistral -> providers\u002FREFERENCE.md\n+-- OpenAI-compatible (vLLM, Together, etc.) -> providers\u002FREFERENCE.md\n+-- Custom\u002Fself-hosted provider -> providers\u002FREFERENCE.md\n```\n\n### \"I need plugins or hooks\"\n\n```\nPlugins?\n+-- Package tools + hooks together -> plugins\u002FREFERENCE.md\n+-- Observe tool calls (logging, metrics) -> plugins\u002FREFERENCE.md\n+-- Intercept lifecycle events -> plugins\u002FREFERENCE.md\n+-- Add system prompt rules -> plugins\u002FREFERENCE.md\n+-- Expose an MCP server's tools -> plugins\u002FREFERENCE.md (MCP servers)\n+-- Bundle reusable skills (SKILL.md, auto slash commands) -> plugins\u002FREFERENCE.md (bundled skills)\n+-- Distribute via npm\u002Fgit -> plugins\u002FREFERENCE.md\n```\n\n### \"I need multi-agent coordination\"\n\n```\nMulti-agent?\n+-- Run one-off delegated sub-agents -> multi-agent\u002FREFERENCE.md (sub-agents)\n+-- Predefined named sub-agents from files -> multi-agent\u002FREFERENCE.md (configured agents)\n+-- Persistent cross-session teams -> multi-agent\u002FREFERENCE.md (teams)\n+-- Parent-child delegation -> multi-agent\u002FREFERENCE.md (sub-agents)\n+-- Peer-to-peer task board -> multi-agent\u002FREFERENCE.md (teams)\n```\n\n### \"I need scheduling or automation\"\n\n```\nScheduling?\n+-- Recurring cron jobs -> scheduling\u002FREFERENCE.md\n+-- One-off scheduled tasks -> scheduling\u002FREFERENCE.md\n+-- Event-driven triggers -> scheduling\u002FREFERENCE.md\n+-- CLI schedule management -> scheduling\u002FREFERENCE.md\n```\n\n### \"I need to go to production\"\n\n```\nProduction?\n+-- Error handling and status checks -> production\u002FREFERENCE.md\n+-- Cost control and token limits -> production\u002FREFERENCE.md\n+-- Observability (OpenTelemetry) -> production\u002FREFERENCE.md\n+-- Security and sandboxing -> production\u002FREFERENCE.md\n+-- Deployment patterns -> production\u002FREFERENCE.md\n```\n\n### Troubleshooting Index\n\n- Agent loop not stopping -> `tools\u002FREFERENCE.md` (completion tools)\n- Tool errors crashing the agent -> `agent\u002Fgotchas.md` or `clinecore\u002Fgotchas.md`\n- Provider auth failures -> `providers\u002FREFERENCE.md`\n- Session not persisting -> `clinecore\u002Fgotchas.md`\n- Token usage too high -> `production\u002FREFERENCE.md` (cost control)\n- Hub connection issues -> `clinecore\u002Fgotchas.md`\n- Plugin not loading -> `plugins\u002FREFERENCE.md`\n- Events not firing -> `events\u002FREFERENCE.md`\n\n## Product Index\n\n### API Surfaces\n| API | Entry File | Description |\n|-----|------------|-------------|\n| Agent | `.\u002Freferences\u002Fagent\u002FREFERENCE.md` | Lightweight in-memory agent loop |\n| ClineCore | `.\u002Freferences\u002Fclinecore\u002FREFERENCE.md` | Full runtime with sessions, persistence, built-in tools |\n\n### Cross-Cutting Concepts\n| Concept | Entry File | Description |\n|---------|------------|-------------|\n| Tools | `.\u002Freferences\u002Ftools\u002FREFERENCE.md` | Built-in and custom tool creation |\n| Plugins | `.\u002Freferences\u002Fplugins\u002FREFERENCE.md` | Extension system with hooks, MCP servers, and bundled skills |\n| Events | `.\u002Freferences\u002Fevents\u002FREFERENCE.md` | Real-time streaming events |\n| Providers | `.\u002Freferences\u002Fproviders\u002FREFERENCE.md` | LLM provider configuration |\n| Production | `.\u002Freferences\u002Fproduction\u002FREFERENCE.md` | Deployment, security, observability |\n| Scheduling | `.\u002Freferences\u002Fscheduling\u002FREFERENCE.md` | Cron jobs and automation |\n| Multi-Agent | `.\u002Freferences\u002Fmulti-agent\u002FREFERENCE.md` | Teams, sub-agents, and configured agent profiles |\n\n### Package Map\n| Package | Purpose |\n|---------|---------|\n| `@cline\u002Fsdk` | User-facing alias for `@cline\u002Fcore`; install this first |\n| `@cline\u002Fcore` | Sessions, persistence, built-in tools, config, hub, and selected re-exports |\n| `@cline\u002Fagents` | Browser-compatible AgentRuntime class and lower-level factories |\n| `@cline\u002Fllms` | LLM provider gateway |\n| `@cline\u002Fshared` | Types, tool helpers, hook engine |\n\n## Resources\n\nRepository: https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline\nSDK Source: https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline\u002Ftree\u002Fmain\u002Fsdk\nDocumentation: https:\u002F\u002Fdocs.cline.bot\u002Fsdk\u002Foverview\nDiscord: https:\u002F\u002Fdiscord.gg\u002Fcline\n",{"data":37,"body":40},{"name":4,"description":6,"metadata":38},{"references":39},"agent, clinecore",{"type":41,"children":42},"root",[43,52,58,65,70,676,682,689,707,720,841,861,867,998,1004,1016,1022,1028,1037,1043,1052,1058,1067,1073,1082,1088,1097,1103,1112,1118,1127,1133,1142,1148,1243,1249,1255,1324,1330,1508,1514,1622,1628],{"type":44,"tag":45,"props":46,"children":48},"element","h1",{"id":47},"cline-sdk-skill",[49],{"type":50,"value":51},"text","Cline SDK Skill",{"type":44,"tag":53,"props":54,"children":55},"p",{},[56],{"type":50,"value":57},"Consolidated skill for building AI agents with the Cline SDK. Use the decision trees below to find the right entry point and API surface, then load detailed references.",{"type":44,"tag":59,"props":60,"children":62},"h2",{"id":61},"critical-rules",[63],{"type":50,"value":64},"Critical Rules",{"type":44,"tag":53,"props":66,"children":67},{},[68],{"type":50,"value":69},"Follow these rules in all Cline SDK code:",{"type":44,"tag":71,"props":72,"children":73},"ol",{},[74,181,186,221,241,253,273,489,575],{"type":44,"tag":75,"props":76,"children":77},"li",{},[78,80,87,89,95,97,103,105,111,113,119,120,126,127,133,135,141,143,149,150,156,158,164,166,172,173,179],{"type":50,"value":79},"Install with ",{"type":44,"tag":81,"props":82,"children":84},"code",{"className":83},[],[85],{"type":50,"value":86},"npm install @cline\u002Fsdk",{"type":50,"value":88},". The ",{"type":44,"tag":81,"props":90,"children":92},{"className":91},[],[93],{"type":50,"value":94},"@cline\u002Fsdk",{"type":50,"value":96}," package re-exports ",{"type":44,"tag":81,"props":98,"children":100},{"className":99},[],[101],{"type":50,"value":102},"@cline\u002Fcore",{"type":50,"value":104},", not every sub-package directly. Core re-exports the public SDK surface such as ",{"type":44,"tag":81,"props":106,"children":108},{"className":107},[],[109],{"type":50,"value":110},"ClineCore",{"type":50,"value":112},", ",{"type":44,"tag":81,"props":114,"children":116},{"className":115},[],[117],{"type":50,"value":118},"Agent",{"type":50,"value":112},{"type":44,"tag":81,"props":121,"children":123},{"className":122},[],[124],{"type":50,"value":125},"createAgentRuntime",{"type":50,"value":112},{"type":44,"tag":81,"props":128,"children":130},{"className":129},[],[131],{"type":50,"value":132},"createTool",{"type":50,"value":134},", built-in tool helpers, provider helpers, and the ",{"type":44,"tag":81,"props":136,"children":138},{"className":137},[],[139],{"type":50,"value":140},"Llms",{"type":50,"value":142}," namespace. Import from ",{"type":44,"tag":81,"props":144,"children":146},{"className":145},[],[147],{"type":50,"value":148},"@cline\u002Fagents",{"type":50,"value":112},{"type":44,"tag":81,"props":151,"children":153},{"className":152},[],[154],{"type":50,"value":155},"@cline\u002Fllms",{"type":50,"value":157},", or ",{"type":44,"tag":81,"props":159,"children":161},{"className":160},[],[162],{"type":50,"value":163},"@cline\u002Fshared",{"type":50,"value":165}," only when you need APIs that core does not re-export, such as ",{"type":44,"tag":81,"props":167,"children":169},{"className":168},[],[170],{"type":50,"value":171},"AgentRuntime",{"type":50,"value":112},{"type":44,"tag":81,"props":174,"children":176},{"className":175},[],[177],{"type":50,"value":178},"createAgent",{"type":50,"value":180},", or some low-level types.",{"type":44,"tag":75,"props":182,"children":183},{},[184],{"type":50,"value":185},"Requires Node.js 22 or later.",{"type":44,"tag":75,"props":187,"children":188},{},[189,191,197,199,204,206,211,213,219],{"type":50,"value":190},"Use ",{"type":44,"tag":81,"props":192,"children":194},{"className":193},[],[195],{"type":50,"value":196},"createTool()",{"type":50,"value":198}," from ",{"type":44,"tag":81,"props":200,"children":202},{"className":201},[],[203],{"type":50,"value":94},{"type":50,"value":205}," (or ",{"type":44,"tag":81,"props":207,"children":209},{"className":208},[],[210],{"type":50,"value":163},{"type":50,"value":212},") to define tools. Tool names must be ",{"type":44,"tag":81,"props":214,"children":216},{"className":215},[],[217],{"type":50,"value":218},"snake_case",{"type":50,"value":220},".",{"type":44,"tag":75,"props":222,"children":223},{},[224,226,232,234,239],{"type":50,"value":225},"Prefer returning structured error data from tool ",{"type":44,"tag":81,"props":227,"children":229},{"className":228},[],[230],{"type":50,"value":231},"execute",{"type":50,"value":233}," functions when the agent can recover. Direct ",{"type":44,"tag":81,"props":235,"children":237},{"className":236},[],[238],{"type":50,"value":118},{"type":50,"value":240}," converts thrown tool errors into error tool results; ClineCore can also count repeated failed tool turns toward its mistake-limit handling.",{"type":44,"tag":75,"props":242,"children":243},{},[244,245,251],{"type":50,"value":190},{"type":44,"tag":81,"props":246,"children":248},{"className":247},[],[249],{"type":50,"value":250},"lifecycle: { completesRun: true }",{"type":50,"value":252}," on tools that should end the agent loop (e.g. a \"submit answer\" tool).",{"type":44,"tag":75,"props":254,"children":255},{},[256,258,263,265,271],{"type":50,"value":257},"When using ",{"type":44,"tag":81,"props":259,"children":261},{"className":260},[],[262],{"type":50,"value":110},{"type":50,"value":264},", always call ",{"type":44,"tag":81,"props":266,"children":268},{"className":267},[],[269],{"type":50,"value":270},"dispose()",{"type":50,"value":272}," when done to clean up resources.",{"type":44,"tag":75,"props":274,"children":275},{},[276,278,283,285,290,292,297,299,305,307,313,315,321,323,329,331,336,337,343,344,350,352,358,360,366,367,373,374,380,381,387,389,395,397,403,405,410,412,418,420,426,428,434,436,441,443,449,451,457,458,464,466,471,473,479,481,487],{"type":50,"value":277},"The direct ",{"type":44,"tag":81,"props":279,"children":281},{"className":280},[],[282],{"type":50,"value":118},{"type":50,"value":284}," and ",{"type":44,"tag":81,"props":286,"children":288},{"className":287},[],[289],{"type":50,"value":110},{"type":50,"value":291}," have different event systems. For ",{"type":44,"tag":81,"props":293,"children":295},{"className":294},[],[296],{"type":50,"value":118},{"type":50,"value":298},": use ",{"type":44,"tag":81,"props":300,"children":302},{"className":301},[],[303],{"type":50,"value":304},"agent.subscribe()",{"type":50,"value":306}," to get ",{"type":44,"tag":81,"props":308,"children":310},{"className":309},[],[311],{"type":50,"value":312},"AgentRuntimeEvent",{"type":50,"value":314}," types, text streaming is ",{"type":44,"tag":81,"props":316,"children":318},{"className":317},[],[319],{"type":50,"value":320},"\"assistant-text-delta\"",{"type":50,"value":322},", and result text is ",{"type":44,"tag":81,"props":324,"children":326},{"className":325},[],[327],{"type":50,"value":328},"result.outputText",{"type":50,"value":330},". For ",{"type":44,"tag":81,"props":332,"children":334},{"className":333},[],[335],{"type":50,"value":110},{"type":50,"value":298},{"type":44,"tag":81,"props":338,"children":340},{"className":339},[],[341],{"type":50,"value":342},"cline.subscribe()",{"type":50,"value":306},{"type":44,"tag":81,"props":345,"children":347},{"className":346},[],[348],{"type":50,"value":349},"CoreSessionEvent",{"type":50,"value":351}," types. Render user-facing text, reasoning, and tool activity from ",{"type":44,"tag":81,"props":353,"children":355},{"className":354},[],[356],{"type":50,"value":357},"\"agent_event\"",{"type":50,"value":359}," payloads (",{"type":44,"tag":81,"props":361,"children":363},{"className":362},[],[364],{"type":50,"value":365},"content_start",{"type":50,"value":112},{"type":44,"tag":81,"props":368,"children":370},{"className":369},[],[371],{"type":50,"value":372},"content_update",{"type":50,"value":112},{"type":44,"tag":81,"props":375,"children":377},{"className":376},[],[378],{"type":50,"value":379},"content_end",{"type":50,"value":112},{"type":44,"tag":81,"props":382,"children":384},{"className":383},[],[385],{"type":50,"value":386},"done",{"type":50,"value":388},"). Treat ",{"type":44,"tag":81,"props":390,"children":392},{"className":391},[],[393],{"type":50,"value":394},"\"chunk\"",{"type":50,"value":396}," events as raw transport chunks with ",{"type":44,"tag":81,"props":398,"children":400},{"className":399},[],[401],{"type":50,"value":402},"{ stream, chunk, ts }",{"type":50,"value":404},", not as typed text deltas. ",{"type":44,"tag":81,"props":406,"children":408},{"className":407},[],[409],{"type":50,"value":110},{"type":50,"value":411}," result text is ",{"type":44,"tag":81,"props":413,"children":415},{"className":414},[],[416],{"type":50,"value":417},"result.text",{"type":50,"value":419},". There is no top-level ",{"type":44,"tag":81,"props":421,"children":423},{"className":422},[],[424],{"type":50,"value":425},"onEvent",{"type":50,"value":427}," field on ",{"type":44,"tag":81,"props":429,"children":431},{"className":430},[],[432],{"type":50,"value":433},"AgentRuntimeConfig",{"type":50,"value":435},"; use ",{"type":44,"tag":81,"props":437,"children":439},{"className":438},[],[440],{"type":50,"value":304},{"type":50,"value":442}," or ",{"type":44,"tag":81,"props":444,"children":446},{"className":445},[],[447],{"type":50,"value":448},"hooks.onEvent",{"type":50,"value":450}," instead. Do not use ",{"type":44,"tag":81,"props":452,"children":454},{"className":453},[],[455],{"type":50,"value":456},"\"content_update\"",{"type":50,"value":442},{"type":44,"tag":81,"props":459,"children":461},{"className":460},[],[462],{"type":50,"value":463},"\"content_start\"",{"type":50,"value":465}," with ",{"type":44,"tag":81,"props":467,"children":469},{"className":468},[],[470],{"type":50,"value":304},{"type":50,"value":472},"; those are host-facing ",{"type":44,"tag":81,"props":474,"children":476},{"className":475},[],[477],{"type":50,"value":478},"AgentEvent",{"type":50,"value":480}," types carried inside ClineCore ",{"type":44,"tag":81,"props":482,"children":484},{"className":483},[],[485],{"type":50,"value":486},"agent_event",{"type":50,"value":488}," events.",{"type":44,"tag":75,"props":490,"children":491},{},[492,494,499,500,506,508,514,516,522,523,528,529,535,537,543,545,551,552,558,560,566,568,574],{"type":50,"value":493},"For direct ",{"type":44,"tag":81,"props":495,"children":497},{"className":496},[],[498],{"type":50,"value":118},{"type":50,"value":112},{"type":44,"tag":81,"props":501,"children":503},{"className":502},[],[504],{"type":50,"value":505},"plugins",{"type":50,"value":507}," are simple runtime plugins with ",{"type":44,"tag":81,"props":509,"children":511},{"className":510},[],[512],{"type":50,"value":513},"setup(context)",{"type":50,"value":515}," returning ",{"type":44,"tag":81,"props":517,"children":519},{"className":518},[],[520],{"type":50,"value":521},"{ tools, hooks }",{"type":50,"value":330},{"type":44,"tag":81,"props":524,"children":526},{"className":525},[],[527],{"type":50,"value":110},{"type":50,"value":112},{"type":44,"tag":81,"props":530,"children":532},{"className":531},[],[533],{"type":50,"value":534},"extensions",{"type":50,"value":536}," are ",{"type":44,"tag":81,"props":538,"children":540},{"className":539},[],[541],{"type":50,"value":542},"AgentPlugin",{"type":50,"value":544}," objects with ",{"type":44,"tag":81,"props":546,"children":548},{"className":547},[],[549],{"type":50,"value":550},"manifest",{"type":50,"value":112},{"type":44,"tag":81,"props":553,"children":555},{"className":554},[],[556],{"type":50,"value":557},"setup(api, ctx)",{"type":50,"value":559},", and optional ",{"type":44,"tag":81,"props":561,"children":563},{"className":562},[],[564],{"type":50,"value":565},"hooks",{"type":50,"value":567},". Do not use ClineCore plugin examples inside direct ",{"type":44,"tag":81,"props":569,"children":571},{"className":570},[],[572],{"type":50,"value":573},"Agent.plugins",{"type":50,"value":220},{"type":44,"tag":75,"props":576,"children":577},{},[578,580,586,588,594,596,602,604,610,612,618,620,626,628,634,636,642,644,650,652,658,660,666,668,674],{"type":50,"value":579},"Plugin skills are ",{"type":44,"tag":581,"props":582,"children":583},"strong",{},[584],{"type":50,"value":585},"file-based",{"type":50,"value":587},", not registered. There is no ",{"type":44,"tag":81,"props":589,"children":591},{"className":590},[],[592],{"type":50,"value":593},"registerSkill()",{"type":50,"value":595}," and no ",{"type":44,"tag":81,"props":597,"children":599},{"className":598},[],[600],{"type":50,"value":601},"api.registerSkill",{"type":50,"value":603},". A plugin ships skills as ",{"type":44,"tag":81,"props":605,"children":607},{"className":606},[],[608],{"type":50,"value":609},"SKILL.md",{"type":50,"value":611}," files under ",{"type":44,"tag":81,"props":613,"children":615},{"className":614},[],[616],{"type":50,"value":617},"\u003Cpackage>\u002Fskills\u002F\u003Cname>\u002FSKILL.md",{"type":50,"value":619}," (package shape required); the host discovers them and surfaces them as ",{"type":44,"tag":81,"props":621,"children":623},{"className":622},[],[624],{"type":50,"value":625},"\u002Fslash-commands",{"type":50,"value":627}," automatically -- do not call ",{"type":44,"tag":81,"props":629,"children":631},{"className":630},[],[632],{"type":50,"value":633},"registerCommand",{"type":50,"value":635}," for skills. Plugin MCP servers use ",{"type":44,"tag":81,"props":637,"children":639},{"className":638},[],[640],{"type":50,"value":641},"api.registerMcpServer()",{"type":50,"value":643}," with the ",{"type":44,"tag":81,"props":645,"children":647},{"className":646},[],[648],{"type":50,"value":649},"\"mcp\"",{"type":50,"value":651}," capability. Configured agents (agent profiles) are YAML files in ",{"type":44,"tag":81,"props":653,"children":655},{"className":654},[],[656],{"type":50,"value":657},".cline\u002Fagents\u002F",{"type":50,"value":659}," loaded as ",{"type":44,"tag":81,"props":661,"children":663},{"className":662},[],[664],{"type":50,"value":665},"subagent_\u003Cname>",{"type":50,"value":667}," tools when ",{"type":44,"tag":81,"props":669,"children":671},{"className":670},[],[672],{"type":50,"value":673},"enableSpawnAgent",{"type":50,"value":675}," is true.",{"type":44,"tag":59,"props":677,"children":679},{"id":678},"how-to-use-this-skill",[680],{"type":50,"value":681},"How to Use This Skill",{"type":44,"tag":683,"props":684,"children":686},"h3",{"id":685},"reference-file-structure",[687],{"type":50,"value":688},"Reference File Structure",{"type":44,"tag":53,"props":690,"children":691},{},[692,694,699,700,705],{"type":50,"value":693},"The two main API surfaces (",{"type":44,"tag":81,"props":695,"children":697},{"className":696},[],[698],{"type":50,"value":118},{"type":50,"value":284},{"type":44,"tag":81,"props":701,"children":703},{"className":702},[],[704],{"type":50,"value":110},{"type":50,"value":706},") follow a 4-file pattern. Cross-cutting concepts are single-file guides.",{"type":44,"tag":53,"props":708,"children":709},{},[710,712,718],{"type":50,"value":711},"Each main API surface in ",{"type":44,"tag":81,"props":713,"children":715},{"className":714},[],[716],{"type":50,"value":717},".\u002Freferences\u002F\u003Capi>\u002F",{"type":50,"value":719}," contains:",{"type":44,"tag":721,"props":722,"children":723},"table",{},[724,748],{"type":44,"tag":725,"props":726,"children":727},"thead",{},[728],{"type":44,"tag":729,"props":730,"children":731},"tr",{},[732,738,743],{"type":44,"tag":733,"props":734,"children":735},"th",{},[736],{"type":50,"value":737},"File",{"type":44,"tag":733,"props":739,"children":740},{},[741],{"type":50,"value":742},"Purpose",{"type":44,"tag":733,"props":744,"children":745},{},[746],{"type":50,"value":747},"When to Read",{"type":44,"tag":749,"props":750,"children":751},"tbody",{},[752,775,797,819],{"type":44,"tag":729,"props":753,"children":754},{},[755,765,770],{"type":44,"tag":756,"props":757,"children":758},"td",{},[759],{"type":44,"tag":81,"props":760,"children":762},{"className":761},[],[763],{"type":50,"value":764},"REFERENCE.md",{"type":44,"tag":756,"props":766,"children":767},{},[768],{"type":50,"value":769},"Overview, when to use, quick start",{"type":44,"tag":756,"props":771,"children":772},{},[773],{"type":50,"value":774},"Always read first",{"type":44,"tag":729,"props":776,"children":777},{},[778,787,792],{"type":44,"tag":756,"props":779,"children":780},{},[781],{"type":44,"tag":81,"props":782,"children":784},{"className":783},[],[785],{"type":50,"value":786},"api.md",{"type":44,"tag":756,"props":788,"children":789},{},[790],{"type":50,"value":791},"Full API: classes, methods, config, types",{"type":44,"tag":756,"props":793,"children":794},{},[795],{"type":50,"value":796},"Writing code",{"type":44,"tag":729,"props":798,"children":799},{},[800,809,814],{"type":44,"tag":756,"props":801,"children":802},{},[803],{"type":44,"tag":81,"props":804,"children":806},{"className":805},[],[807],{"type":50,"value":808},"patterns.md",{"type":44,"tag":756,"props":810,"children":811},{},[812],{"type":50,"value":813},"Common patterns, best practices",{"type":44,"tag":756,"props":815,"children":816},{},[817],{"type":50,"value":818},"Implementation guidance",{"type":44,"tag":729,"props":820,"children":821},{},[822,831,836],{"type":44,"tag":756,"props":823,"children":824},{},[825],{"type":44,"tag":81,"props":826,"children":828},{"className":827},[],[829],{"type":50,"value":830},"gotchas.md",{"type":44,"tag":756,"props":832,"children":833},{},[834],{"type":50,"value":835},"Pitfalls, limitations, debugging",{"type":44,"tag":756,"props":837,"children":838},{},[839],{"type":50,"value":840},"Troubleshooting",{"type":44,"tag":53,"props":842,"children":843},{},[844,846,852,854,859],{"type":50,"value":845},"Cross-cutting concepts in ",{"type":44,"tag":81,"props":847,"children":849},{"className":848},[],[850],{"type":50,"value":851},".\u002Freferences\u002F\u003Cconcept>\u002F",{"type":50,"value":853}," have ",{"type":44,"tag":81,"props":855,"children":857},{"className":856},[],[858],{"type":50,"value":764},{"type":50,"value":860}," as the entry point.",{"type":44,"tag":683,"props":862,"children":864},{"id":863},"reading-order",[865],{"type":50,"value":866},"Reading Order",{"type":44,"tag":71,"props":868,"children":869},{},[870,882],{"type":44,"tag":75,"props":871,"children":872},{},[873,875,880],{"type":50,"value":874},"Start with ",{"type":44,"tag":81,"props":876,"children":878},{"className":877},[],[879],{"type":50,"value":764},{"type":50,"value":881}," for your chosen API surface",{"type":44,"tag":75,"props":883,"children":884},{},[885,887],{"type":50,"value":886},"Then read additional files relevant to your task:\n",{"type":44,"tag":888,"props":889,"children":890},"ul",{},[891,901,911,922,933,944,955,966,977,988],{"type":44,"tag":75,"props":892,"children":893},{},[894,896],{"type":50,"value":895},"Writing agent code -> ",{"type":44,"tag":81,"props":897,"children":899},{"className":898},[],[900],{"type":50,"value":786},{"type":44,"tag":75,"props":902,"children":903},{},[904,906],{"type":50,"value":905},"Common patterns -> ",{"type":44,"tag":81,"props":907,"children":909},{"className":908},[],[910],{"type":50,"value":808},{"type":44,"tag":75,"props":912,"children":913},{},[914,916],{"type":50,"value":915},"Creating tools -> ",{"type":44,"tag":81,"props":917,"children":919},{"className":918},[],[920],{"type":50,"value":921},"tools\u002FREFERENCE.md",{"type":44,"tag":75,"props":923,"children":924},{},[925,927],{"type":50,"value":926},"Adding plugins\u002Fhooks -> ",{"type":44,"tag":81,"props":928,"children":930},{"className":929},[],[931],{"type":50,"value":932},"plugins\u002FREFERENCE.md",{"type":44,"tag":75,"props":934,"children":935},{},[936,938],{"type":50,"value":937},"Configuring LLM providers -> ",{"type":44,"tag":81,"props":939,"children":941},{"className":940},[],[942],{"type":50,"value":943},"providers\u002FREFERENCE.md",{"type":44,"tag":75,"props":945,"children":946},{},[947,949],{"type":50,"value":948},"Streaming events -> ",{"type":44,"tag":81,"props":950,"children":952},{"className":951},[],[953],{"type":50,"value":954},"events\u002FREFERENCE.md",{"type":44,"tag":75,"props":956,"children":957},{},[958,960],{"type":50,"value":959},"Deploying to production -> ",{"type":44,"tag":81,"props":961,"children":963},{"className":962},[],[964],{"type":50,"value":965},"production\u002FREFERENCE.md",{"type":44,"tag":75,"props":967,"children":968},{},[969,971],{"type":50,"value":970},"Scheduling agents -> ",{"type":44,"tag":81,"props":972,"children":974},{"className":973},[],[975],{"type":50,"value":976},"scheduling\u002FREFERENCE.md",{"type":44,"tag":75,"props":978,"children":979},{},[980,982],{"type":50,"value":981},"Multi-agent orchestration -> ",{"type":44,"tag":81,"props":983,"children":985},{"className":984},[],[986],{"type":50,"value":987},"multi-agent\u002FREFERENCE.md",{"type":44,"tag":75,"props":989,"children":990},{},[991,993],{"type":50,"value":992},"Debugging -> ",{"type":44,"tag":81,"props":994,"children":996},{"className":995},[],[997],{"type":50,"value":830},{"type":44,"tag":683,"props":999,"children":1001},{"id":1000},"example-paths",[1002],{"type":50,"value":1003},"Example Paths",{"type":44,"tag":1005,"props":1006,"children":1010},"pre",{"className":1007,"code":1009,"language":50},[1008],"language-text",".\u002Freferences\u002Fagent\u002FREFERENCE.md           # Start here for lightweight agents\n.\u002Freferences\u002Fclinecore\u002FREFERENCE.md       # Start here for full runtime\n.\u002Freferences\u002Fagent\u002Fapi.md                 # Agent class, config, methods\n.\u002Freferences\u002Ftools\u002FREFERENCE.md           # Creating and using tools\n.\u002Freferences\u002Fplugins\u002FREFERENCE.md         # Plugin system\n.\u002Freferences\u002Fproviders\u002FREFERENCE.md       # LLM provider configuration\n",[1011],{"type":44,"tag":81,"props":1012,"children":1014},{"__ignoreMap":1013},"",[1015],{"type":50,"value":1009},{"type":44,"tag":59,"props":1017,"children":1019},{"id":1018},"quick-decision-trees",[1020],{"type":50,"value":1021},"Quick Decision Trees",{"type":44,"tag":683,"props":1023,"children":1025},{"id":1024},"which-api-surface-should-i-use",[1026],{"type":50,"value":1027},"\"Which API surface should I use?\"",{"type":44,"tag":1005,"props":1029,"children":1032},{"className":1030,"code":1031,"language":50},[1008],"Which API?\n+-- I want a simple, in-memory agent with custom tools\n|   +-- agent\u002F (Agent class from @cline\u002Fagents, re-exported by @cline\u002Fsdk)\n+-- I need session persistence, built-in tools, config discovery\n|   +-- clinecore\u002F (ClineCore from @cline\u002Fcore)\n+-- I want built-in file\u002Fshell\u002Fsearch\u002Fweb tools\n|   +-- clinecore\u002F (has built-in tools; Agent does not)\n+-- I want scheduled or recurring agents\n|   +-- clinecore\u002F (automation API)\n+-- I need multi-process or multi-client session sharing\n|   +-- clinecore\u002F (hub-backed runtime)\n+-- I'm building a browser-compatible agent\n|   +-- agent\u002F (no Node.js dependencies)\n",[1033],{"type":44,"tag":81,"props":1034,"children":1035},{"__ignoreMap":1013},[1036],{"type":50,"value":1031},{"type":44,"tag":683,"props":1038,"children":1040},{"id":1039},"i-need-to-create-tools",[1041],{"type":50,"value":1042},"\"I need to create tools\"",{"type":44,"tag":1005,"props":1044,"children":1047},{"className":1045,"code":1046,"language":50},[1008],"Tools?\n+-- Define a custom tool with schema -> tools\u002FREFERENCE.md\n+-- Use built-in tools (read_files, search_codebase, run_commands, etc.) -> tools\u002FREFERENCE.md (built-in section)\n+-- Control tool approval\u002Fpolicies -> tools\u002FREFERENCE.md (policies section)\n+-- Tool that ends the agent loop -> tools\u002FREFERENCE.md (completion tools)\n+-- Package tools as a reusable plugin -> plugins\u002FREFERENCE.md\n",[1048],{"type":44,"tag":81,"props":1049,"children":1050},{"__ignoreMap":1013},[1051],{"type":50,"value":1046},{"type":44,"tag":683,"props":1053,"children":1055},{"id":1054},"i-need-to-handle-events",[1056],{"type":50,"value":1057},"\"I need to handle events\"",{"type":44,"tag":1005,"props":1059,"children":1062},{"className":1060,"code":1061,"language":50},[1008],"Events?\n+-- Stream text\u002Freasoning in real time -> events\u002FREFERENCE.md\n+-- Track token usage and costs -> events\u002FREFERENCE.md\n+-- Watch tool calls -> events\u002FREFERENCE.md\n+-- Detect completion\u002Ferrors -> events\u002FREFERENCE.md\n+-- Hook into lifecycle stages -> plugins\u002FREFERENCE.md\n",[1063],{"type":44,"tag":81,"props":1064,"children":1065},{"__ignoreMap":1013},[1066],{"type":50,"value":1061},{"type":44,"tag":683,"props":1068,"children":1070},{"id":1069},"i-need-to-configure-a-model-provider",[1071],{"type":50,"value":1072},"\"I need to configure a model provider\"",{"type":44,"tag":1005,"props":1074,"children":1077},{"className":1075,"code":1076,"language":50},[1008],"Providers?\n+-- Anthropic (Claude) -> providers\u002FREFERENCE.md\n+-- OpenAI (GPT) -> providers\u002FREFERENCE.md\n+-- Google (Gemini\u002FVertex) -> providers\u002FREFERENCE.md\n+-- AWS Bedrock -> providers\u002FREFERENCE.md\n+-- Mistral -> providers\u002FREFERENCE.md\n+-- OpenAI-compatible (vLLM, Together, etc.) -> providers\u002FREFERENCE.md\n+-- Custom\u002Fself-hosted provider -> providers\u002FREFERENCE.md\n",[1078],{"type":44,"tag":81,"props":1079,"children":1080},{"__ignoreMap":1013},[1081],{"type":50,"value":1076},{"type":44,"tag":683,"props":1083,"children":1085},{"id":1084},"i-need-plugins-or-hooks",[1086],{"type":50,"value":1087},"\"I need plugins or hooks\"",{"type":44,"tag":1005,"props":1089,"children":1092},{"className":1090,"code":1091,"language":50},[1008],"Plugins?\n+-- Package tools + hooks together -> plugins\u002FREFERENCE.md\n+-- Observe tool calls (logging, metrics) -> plugins\u002FREFERENCE.md\n+-- Intercept lifecycle events -> plugins\u002FREFERENCE.md\n+-- Add system prompt rules -> plugins\u002FREFERENCE.md\n+-- Expose an MCP server's tools -> plugins\u002FREFERENCE.md (MCP servers)\n+-- Bundle reusable skills (SKILL.md, auto slash commands) -> plugins\u002FREFERENCE.md (bundled skills)\n+-- Distribute via npm\u002Fgit -> plugins\u002FREFERENCE.md\n",[1093],{"type":44,"tag":81,"props":1094,"children":1095},{"__ignoreMap":1013},[1096],{"type":50,"value":1091},{"type":44,"tag":683,"props":1098,"children":1100},{"id":1099},"i-need-multi-agent-coordination",[1101],{"type":50,"value":1102},"\"I need multi-agent coordination\"",{"type":44,"tag":1005,"props":1104,"children":1107},{"className":1105,"code":1106,"language":50},[1008],"Multi-agent?\n+-- Run one-off delegated sub-agents -> multi-agent\u002FREFERENCE.md (sub-agents)\n+-- Predefined named sub-agents from files -> multi-agent\u002FREFERENCE.md (configured agents)\n+-- Persistent cross-session teams -> multi-agent\u002FREFERENCE.md (teams)\n+-- Parent-child delegation -> multi-agent\u002FREFERENCE.md (sub-agents)\n+-- Peer-to-peer task board -> multi-agent\u002FREFERENCE.md (teams)\n",[1108],{"type":44,"tag":81,"props":1109,"children":1110},{"__ignoreMap":1013},[1111],{"type":50,"value":1106},{"type":44,"tag":683,"props":1113,"children":1115},{"id":1114},"i-need-scheduling-or-automation",[1116],{"type":50,"value":1117},"\"I need scheduling or automation\"",{"type":44,"tag":1005,"props":1119,"children":1122},{"className":1120,"code":1121,"language":50},[1008],"Scheduling?\n+-- Recurring cron jobs -> scheduling\u002FREFERENCE.md\n+-- One-off scheduled tasks -> scheduling\u002FREFERENCE.md\n+-- Event-driven triggers -> scheduling\u002FREFERENCE.md\n+-- CLI schedule management -> scheduling\u002FREFERENCE.md\n",[1123],{"type":44,"tag":81,"props":1124,"children":1125},{"__ignoreMap":1013},[1126],{"type":50,"value":1121},{"type":44,"tag":683,"props":1128,"children":1130},{"id":1129},"i-need-to-go-to-production",[1131],{"type":50,"value":1132},"\"I need to go to production\"",{"type":44,"tag":1005,"props":1134,"children":1137},{"className":1135,"code":1136,"language":50},[1008],"Production?\n+-- Error handling and status checks -> production\u002FREFERENCE.md\n+-- Cost control and token limits -> production\u002FREFERENCE.md\n+-- Observability (OpenTelemetry) -> production\u002FREFERENCE.md\n+-- Security and sandboxing -> production\u002FREFERENCE.md\n+-- Deployment patterns -> production\u002FREFERENCE.md\n",[1138],{"type":44,"tag":81,"props":1139,"children":1140},{"__ignoreMap":1013},[1141],{"type":50,"value":1136},{"type":44,"tag":683,"props":1143,"children":1145},{"id":1144},"troubleshooting-index",[1146],{"type":50,"value":1147},"Troubleshooting Index",{"type":44,"tag":888,"props":1149,"children":1150},{},[1151,1163,1181,1191,1201,1213,1223,1233],{"type":44,"tag":75,"props":1152,"children":1153},{},[1154,1156,1161],{"type":50,"value":1155},"Agent loop not stopping -> ",{"type":44,"tag":81,"props":1157,"children":1159},{"className":1158},[],[1160],{"type":50,"value":921},{"type":50,"value":1162}," (completion tools)",{"type":44,"tag":75,"props":1164,"children":1165},{},[1166,1168,1174,1175],{"type":50,"value":1167},"Tool errors crashing the agent -> ",{"type":44,"tag":81,"props":1169,"children":1171},{"className":1170},[],[1172],{"type":50,"value":1173},"agent\u002Fgotchas.md",{"type":50,"value":442},{"type":44,"tag":81,"props":1176,"children":1178},{"className":1177},[],[1179],{"type":50,"value":1180},"clinecore\u002Fgotchas.md",{"type":44,"tag":75,"props":1182,"children":1183},{},[1184,1186],{"type":50,"value":1185},"Provider auth failures -> ",{"type":44,"tag":81,"props":1187,"children":1189},{"className":1188},[],[1190],{"type":50,"value":943},{"type":44,"tag":75,"props":1192,"children":1193},{},[1194,1196],{"type":50,"value":1195},"Session not persisting -> ",{"type":44,"tag":81,"props":1197,"children":1199},{"className":1198},[],[1200],{"type":50,"value":1180},{"type":44,"tag":75,"props":1202,"children":1203},{},[1204,1206,1211],{"type":50,"value":1205},"Token usage too high -> ",{"type":44,"tag":81,"props":1207,"children":1209},{"className":1208},[],[1210],{"type":50,"value":965},{"type":50,"value":1212}," (cost control)",{"type":44,"tag":75,"props":1214,"children":1215},{},[1216,1218],{"type":50,"value":1217},"Hub connection issues -> ",{"type":44,"tag":81,"props":1219,"children":1221},{"className":1220},[],[1222],{"type":50,"value":1180},{"type":44,"tag":75,"props":1224,"children":1225},{},[1226,1228],{"type":50,"value":1227},"Plugin not loading -> ",{"type":44,"tag":81,"props":1229,"children":1231},{"className":1230},[],[1232],{"type":50,"value":932},{"type":44,"tag":75,"props":1234,"children":1235},{},[1236,1238],{"type":50,"value":1237},"Events not firing -> ",{"type":44,"tag":81,"props":1239,"children":1241},{"className":1240},[],[1242],{"type":50,"value":954},{"type":44,"tag":59,"props":1244,"children":1246},{"id":1245},"product-index",[1247],{"type":50,"value":1248},"Product Index",{"type":44,"tag":683,"props":1250,"children":1252},{"id":1251},"api-surfaces",[1253],{"type":50,"value":1254},"API Surfaces",{"type":44,"tag":721,"props":1256,"children":1257},{},[1258,1279],{"type":44,"tag":725,"props":1259,"children":1260},{},[1261],{"type":44,"tag":729,"props":1262,"children":1263},{},[1264,1269,1274],{"type":44,"tag":733,"props":1265,"children":1266},{},[1267],{"type":50,"value":1268},"API",{"type":44,"tag":733,"props":1270,"children":1271},{},[1272],{"type":50,"value":1273},"Entry File",{"type":44,"tag":733,"props":1275,"children":1276},{},[1277],{"type":50,"value":1278},"Description",{"type":44,"tag":749,"props":1280,"children":1281},{},[1282,1303],{"type":44,"tag":729,"props":1283,"children":1284},{},[1285,1289,1298],{"type":44,"tag":756,"props":1286,"children":1287},{},[1288],{"type":50,"value":118},{"type":44,"tag":756,"props":1290,"children":1291},{},[1292],{"type":44,"tag":81,"props":1293,"children":1295},{"className":1294},[],[1296],{"type":50,"value":1297},".\u002Freferences\u002Fagent\u002FREFERENCE.md",{"type":44,"tag":756,"props":1299,"children":1300},{},[1301],{"type":50,"value":1302},"Lightweight in-memory agent loop",{"type":44,"tag":729,"props":1304,"children":1305},{},[1306,1310,1319],{"type":44,"tag":756,"props":1307,"children":1308},{},[1309],{"type":50,"value":110},{"type":44,"tag":756,"props":1311,"children":1312},{},[1313],{"type":44,"tag":81,"props":1314,"children":1316},{"className":1315},[],[1317],{"type":50,"value":1318},".\u002Freferences\u002Fclinecore\u002FREFERENCE.md",{"type":44,"tag":756,"props":1320,"children":1321},{},[1322],{"type":50,"value":1323},"Full runtime with sessions, persistence, built-in tools",{"type":44,"tag":683,"props":1325,"children":1327},{"id":1326},"cross-cutting-concepts",[1328],{"type":50,"value":1329},"Cross-Cutting Concepts",{"type":44,"tag":721,"props":1331,"children":1332},{},[1333,1352],{"type":44,"tag":725,"props":1334,"children":1335},{},[1336],{"type":44,"tag":729,"props":1337,"children":1338},{},[1339,1344,1348],{"type":44,"tag":733,"props":1340,"children":1341},{},[1342],{"type":50,"value":1343},"Concept",{"type":44,"tag":733,"props":1345,"children":1346},{},[1347],{"type":50,"value":1273},{"type":44,"tag":733,"props":1349,"children":1350},{},[1351],{"type":50,"value":1278},{"type":44,"tag":749,"props":1353,"children":1354},{},[1355,1377,1399,1421,1443,1465,1487],{"type":44,"tag":729,"props":1356,"children":1357},{},[1358,1363,1372],{"type":44,"tag":756,"props":1359,"children":1360},{},[1361],{"type":50,"value":1362},"Tools",{"type":44,"tag":756,"props":1364,"children":1365},{},[1366],{"type":44,"tag":81,"props":1367,"children":1369},{"className":1368},[],[1370],{"type":50,"value":1371},".\u002Freferences\u002Ftools\u002FREFERENCE.md",{"type":44,"tag":756,"props":1373,"children":1374},{},[1375],{"type":50,"value":1376},"Built-in and custom tool creation",{"type":44,"tag":729,"props":1378,"children":1379},{},[1380,1385,1394],{"type":44,"tag":756,"props":1381,"children":1382},{},[1383],{"type":50,"value":1384},"Plugins",{"type":44,"tag":756,"props":1386,"children":1387},{},[1388],{"type":44,"tag":81,"props":1389,"children":1391},{"className":1390},[],[1392],{"type":50,"value":1393},".\u002Freferences\u002Fplugins\u002FREFERENCE.md",{"type":44,"tag":756,"props":1395,"children":1396},{},[1397],{"type":50,"value":1398},"Extension system with hooks, MCP servers, and bundled skills",{"type":44,"tag":729,"props":1400,"children":1401},{},[1402,1407,1416],{"type":44,"tag":756,"props":1403,"children":1404},{},[1405],{"type":50,"value":1406},"Events",{"type":44,"tag":756,"props":1408,"children":1409},{},[1410],{"type":44,"tag":81,"props":1411,"children":1413},{"className":1412},[],[1414],{"type":50,"value":1415},".\u002Freferences\u002Fevents\u002FREFERENCE.md",{"type":44,"tag":756,"props":1417,"children":1418},{},[1419],{"type":50,"value":1420},"Real-time streaming events",{"type":44,"tag":729,"props":1422,"children":1423},{},[1424,1429,1438],{"type":44,"tag":756,"props":1425,"children":1426},{},[1427],{"type":50,"value":1428},"Providers",{"type":44,"tag":756,"props":1430,"children":1431},{},[1432],{"type":44,"tag":81,"props":1433,"children":1435},{"className":1434},[],[1436],{"type":50,"value":1437},".\u002Freferences\u002Fproviders\u002FREFERENCE.md",{"type":44,"tag":756,"props":1439,"children":1440},{},[1441],{"type":50,"value":1442},"LLM provider configuration",{"type":44,"tag":729,"props":1444,"children":1445},{},[1446,1451,1460],{"type":44,"tag":756,"props":1447,"children":1448},{},[1449],{"type":50,"value":1450},"Production",{"type":44,"tag":756,"props":1452,"children":1453},{},[1454],{"type":44,"tag":81,"props":1455,"children":1457},{"className":1456},[],[1458],{"type":50,"value":1459},".\u002Freferences\u002Fproduction\u002FREFERENCE.md",{"type":44,"tag":756,"props":1461,"children":1462},{},[1463],{"type":50,"value":1464},"Deployment, security, observability",{"type":44,"tag":729,"props":1466,"children":1467},{},[1468,1473,1482],{"type":44,"tag":756,"props":1469,"children":1470},{},[1471],{"type":50,"value":1472},"Scheduling",{"type":44,"tag":756,"props":1474,"children":1475},{},[1476],{"type":44,"tag":81,"props":1477,"children":1479},{"className":1478},[],[1480],{"type":50,"value":1481},".\u002Freferences\u002Fscheduling\u002FREFERENCE.md",{"type":44,"tag":756,"props":1483,"children":1484},{},[1485],{"type":50,"value":1486},"Cron jobs and automation",{"type":44,"tag":729,"props":1488,"children":1489},{},[1490,1494,1503],{"type":44,"tag":756,"props":1491,"children":1492},{},[1493],{"type":50,"value":23},{"type":44,"tag":756,"props":1495,"children":1496},{},[1497],{"type":44,"tag":81,"props":1498,"children":1500},{"className":1499},[],[1501],{"type":50,"value":1502},".\u002Freferences\u002Fmulti-agent\u002FREFERENCE.md",{"type":44,"tag":756,"props":1504,"children":1505},{},[1506],{"type":50,"value":1507},"Teams, sub-agents, and configured agent profiles",{"type":44,"tag":683,"props":1509,"children":1511},{"id":1510},"package-map",[1512],{"type":50,"value":1513},"Package Map",{"type":44,"tag":721,"props":1515,"children":1516},{},[1517,1532],{"type":44,"tag":725,"props":1518,"children":1519},{},[1520],{"type":44,"tag":729,"props":1521,"children":1522},{},[1523,1528],{"type":44,"tag":733,"props":1524,"children":1525},{},[1526],{"type":50,"value":1527},"Package",{"type":44,"tag":733,"props":1529,"children":1530},{},[1531],{"type":50,"value":742},{"type":44,"tag":749,"props":1533,"children":1534},{},[1535,1558,1574,1590,1606],{"type":44,"tag":729,"props":1536,"children":1537},{},[1538,1546],{"type":44,"tag":756,"props":1539,"children":1540},{},[1541],{"type":44,"tag":81,"props":1542,"children":1544},{"className":1543},[],[1545],{"type":50,"value":94},{"type":44,"tag":756,"props":1547,"children":1548},{},[1549,1551,1556],{"type":50,"value":1550},"User-facing alias for ",{"type":44,"tag":81,"props":1552,"children":1554},{"className":1553},[],[1555],{"type":50,"value":102},{"type":50,"value":1557},"; install this first",{"type":44,"tag":729,"props":1559,"children":1560},{},[1561,1569],{"type":44,"tag":756,"props":1562,"children":1563},{},[1564],{"type":44,"tag":81,"props":1565,"children":1567},{"className":1566},[],[1568],{"type":50,"value":102},{"type":44,"tag":756,"props":1570,"children":1571},{},[1572],{"type":50,"value":1573},"Sessions, persistence, built-in tools, config, hub, and selected re-exports",{"type":44,"tag":729,"props":1575,"children":1576},{},[1577,1585],{"type":44,"tag":756,"props":1578,"children":1579},{},[1580],{"type":44,"tag":81,"props":1581,"children":1583},{"className":1582},[],[1584],{"type":50,"value":148},{"type":44,"tag":756,"props":1586,"children":1587},{},[1588],{"type":50,"value":1589},"Browser-compatible AgentRuntime class and lower-level factories",{"type":44,"tag":729,"props":1591,"children":1592},{},[1593,1601],{"type":44,"tag":756,"props":1594,"children":1595},{},[1596],{"type":44,"tag":81,"props":1597,"children":1599},{"className":1598},[],[1600],{"type":50,"value":155},{"type":44,"tag":756,"props":1602,"children":1603},{},[1604],{"type":50,"value":1605},"LLM provider gateway",{"type":44,"tag":729,"props":1607,"children":1608},{},[1609,1617],{"type":44,"tag":756,"props":1610,"children":1611},{},[1612],{"type":44,"tag":81,"props":1613,"children":1615},{"className":1614},[],[1616],{"type":50,"value":163},{"type":44,"tag":756,"props":1618,"children":1619},{},[1620],{"type":50,"value":1621},"Types, tool helpers, hook engine",{"type":44,"tag":59,"props":1623,"children":1625},{"id":1624},"resources",[1626],{"type":50,"value":1627},"Resources",{"type":44,"tag":53,"props":1629,"children":1630},{},[1631,1633,1641,1643,1649,1651,1657,1659],{"type":50,"value":1632},"Repository: ",{"type":44,"tag":1634,"props":1635,"children":1639},"a",{"href":1636,"rel":1637},"https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline",[1638],"nofollow",[1640],{"type":50,"value":1636},{"type":50,"value":1642},"\nSDK Source: ",{"type":44,"tag":1634,"props":1644,"children":1647},{"href":1645,"rel":1646},"https:\u002F\u002Fgithub.com\u002Fcline\u002Fcline\u002Ftree\u002Fmain\u002Fsdk",[1638],[1648],{"type":50,"value":1645},{"type":50,"value":1650},"\nDocumentation: ",{"type":44,"tag":1634,"props":1652,"children":1655},{"href":1653,"rel":1654},"https:\u002F\u002Fdocs.cline.bot\u002Fsdk\u002Foverview",[1638],[1656],{"type":50,"value":1653},{"type":50,"value":1658},"\nDiscord: ",{"type":44,"tag":1634,"props":1660,"children":1663},{"href":1661,"rel":1662},"https:\u002F\u002Fdiscord.gg\u002Fcline",[1638],[1664],{"type":50,"value":1661},{"items":1666,"total":1674},[1667],{"slug":4,"name":4,"fn":5,"description":6,"org":1668,"tags":1669,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1670,1671,1672,1673],{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},1,{"items":1676,"total":1873},[1677,1698,1718,1737,1754,1770,1785,1797,1809,1827,1847,1860],{"slug":1678,"name":1678,"fn":1679,"description":1680,"org":1681,"tags":1682,"stars":1695,"repoUrl":1696,"updatedAt":1697},"amazon-location-service","integrate Amazon Location Service APIs","Integrates Amazon Location Service APIs for AWS applications. Use this skill when users want to add maps (interactive MapLibre or static images); geocode addresses to coordinates or reverse geocode coordinates to addresses; calculate routes, travel times, or service areas; find places and businesses through text search, nearby search, or autocomplete suggestions; retrieve detailed place information including hours, contacts, and addresses; monitor geographical boundaries with geofences; or track device locations. Covers authentication, SDK integration, and all Amazon Location Service capabilities.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1683,1686,1689,1692],{"name":1684,"slug":1685,"type":15},"API Development","api-development",{"name":1687,"slug":1688,"type":15},"AWS","aws",{"name":1690,"slug":1691,"type":15},"Maps","maps",{"name":1693,"slug":1694,"type":15},"Navigation","navigation",10,"https:\u002F\u002Fgithub.com\u002Fcline\u002Fskills","2026-07-12T08:13:53.294026",{"slug":1699,"name":1699,"fn":1700,"description":1701,"org":1702,"tags":1703,"stars":1695,"repoUrl":1696,"updatedAt":1717},"amplify-workflow","build full-stack apps with AWS Amplify","Build and deploy full-stack web and mobile apps with AWS Amplify Gen2 (TypeScript code-first). Covers auth (Cognito), data (AppSync\u002FDynamoDB including schema modeling, enum types, relationships, authorization rules), storage (S3), functions, APIs, and AI (Amplify AI Kit with Bedrock). Supports React, Next.js, Vue, Angular, React Native, Flutter, Swift, and Android. Always use this skill for Amplify Gen2 topics — even for questions you think you know — it contains validated, version-specific patterns that prevent common mistakes. TRIGGER when: user mentions Amplify Gen2; project has amplify\u002F directory or amplify_outputs; code imports @aws-amplify packages; user asks about defineBackend, defineAuth, defineData, defineStorage, or npx ampx. SKIP: Amplify Gen1 (amplify CLI v6), standalone SAM\u002FCDK without Amplify (use aws-serverless), direct Bedrock without Amplify AI Kit (use bedrock).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1704,1707,1708,1711,1714],{"name":1705,"slug":1706,"type":15},"Auth","auth",{"name":1687,"slug":1688,"type":15},{"name":1709,"slug":1710,"type":15},"Database","database",{"name":1712,"slug":1713,"type":15},"Frontend","frontend",{"name":1715,"slug":1716,"type":15},"TypeScript","typescript","2026-07-12T08:13:47.134012",{"slug":1719,"name":1719,"fn":1720,"description":1721,"org":1722,"tags":1723,"stars":1695,"repoUrl":1696,"updatedAt":1736},"analyzer","analyze queried data for trends","Analyze queried data for trends, week-over-week comparisons, distributions, funnels, cohorts, top-N lists, anomalies, sanity checks, and report-ready findings. Use after or alongside ClickHouse queries when the user wants insight rather than raw rows.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1724,1727,1730,1733],{"name":1725,"slug":1726,"type":15},"Analytics","analytics",{"name":1728,"slug":1729,"type":15},"ClickHouse","clickhouse",{"name":1731,"slug":1732,"type":15},"Data Analysis","data-analysis",{"name":1734,"slug":1735,"type":15},"Statistics","statistics","2026-07-12T08:14:05.606036",{"slug":1738,"name":1738,"fn":1739,"description":1740,"org":1741,"tags":1742,"stars":1695,"repoUrl":1696,"updatedAt":1753},"artifact-management","manage and organize analysis artifacts","Save, organize, and describe reusable analysis artifacts such as SQL, result snapshots, CSV exports, summaries, caveats, plots, and report-ready files. Use when users ask to save, export, share, cite, reproduce, or organize data-analysis outputs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1743,1744,1747,1750],{"name":1731,"slug":1732,"type":15},{"name":1745,"slug":1746,"type":15},"Productivity","productivity",{"name":1748,"slug":1749,"type":15},"Reporting","reporting",{"name":1751,"slug":1752,"type":15},"SQL","sql","2026-07-12T08:14:09.265555",{"slug":1755,"name":1755,"fn":1756,"description":1757,"org":1758,"tags":1759,"stars":1695,"repoUrl":1696,"updatedAt":1769},"attorney-assist","connect with attorneys for legal consultation","Connects the user with a LegalZoom attorney for legal consultation. Use when a user asks about attorneys, lawyers, or legal help, or when contract review reveals high risks or low-confidence findings.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1760,1763,1766],{"name":1761,"slug":1762,"type":15},"Contracts","contracts",{"name":1764,"slug":1765,"type":15},"Legal","legal",{"name":1767,"slug":1768,"type":15},"Risk Assessment","risk-assessment","2026-07-12T08:13:45.878361",{"slug":1771,"name":1771,"fn":1772,"description":1773,"org":1774,"tags":1775,"stars":1695,"repoUrl":1696,"updatedAt":1784},"building-pydantic-ai-agents","build AI agents with Pydantic AI","Build AI agents with Pydantic AI — tools, capabilities (including on-demand loading), structured output, streaming, testing, and multi-agent patterns. Use when the user mentions Pydantic AI, imports pydantic_ai, or asks to build an AI agent, add tools\u002Fcapabilities, defer capability loading, stream output, define agents from YAML, or test agent behavior.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1776,1777,1780,1781],{"name":13,"slug":14,"type":15},{"name":1778,"slug":1779,"type":15},"LLM","llm",{"name":23,"slug":24,"type":15},{"name":1782,"slug":1783,"type":15},"Python","python","2026-07-12T08:14:01.893781",{"slug":1729,"name":1729,"fn":1786,"description":1787,"org":1788,"tags":1789,"stars":1695,"repoUrl":1696,"updatedAt":1796},"query ClickHouse databases via CLI","Connect to and query ClickHouse (a local server or a ClickHouse Cloud service) from the terminal using the official clickhousectl CLI, including the browser OAuth login flow. Use when the user wants to run SQL against ClickHouse, explore schemas and tables, inspect Cloud services, or authenticate clickhousectl. For building a local dev environment or deploying to Cloud, defer to the official ClickHouse skills (see Scope).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1790,1791,1794,1795],{"name":1725,"slug":1726,"type":15},{"name":1792,"slug":1793,"type":15},"CLI","cli",{"name":1728,"slug":1729,"type":15},{"name":1709,"slug":1710,"type":15},"2026-07-12T08:14:06.829692",{"slug":1798,"name":1798,"fn":1799,"description":1800,"org":1801,"tags":1802,"stars":1695,"repoUrl":1696,"updatedAt":1808},"cline-session-history","search and browse Cline session history","Search and browse Cline session history. Use when the user asks to find, list, inspect, or export Cline sessions by time period, prompt content, status, model, provider, source, mode, workspace, or other criteria. Also use when the user wants to read a session transcript or export sessions to a directory. Trigger phrases include \"find my session\", \"search my session history\", \"show me past sessions\", \"what was that session where\", \"find the session that started with\", and any mention of past Cline conversations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1803,1804,1807],{"name":13,"slug":14,"type":15},{"name":1805,"slug":1806,"type":15},"History","history",{"name":1745,"slug":1746,"type":15},"2026-07-19T06:03:13.945151",{"slug":1810,"name":1810,"fn":1811,"description":1812,"org":1813,"tags":1814,"stars":1695,"repoUrl":1696,"updatedAt":1826},"convex-design","build reactive backends with Convex","Design and build reactive, type-safe, production-grade backends on Convex. Covers schema, queries\u002Fmutations\u002Factions, indexes, auth, file storage, scheduling, real-time multiplayer, mobile backends, and LLM\u002Fagent workflows on Convex's one-platform stack.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1815,1816,1819,1820,1823],{"name":1705,"slug":1706,"type":15},{"name":1817,"slug":1818,"type":15},"Backend","backend",{"name":1709,"slug":1710,"type":15},{"name":1821,"slug":1822,"type":15},"Real-time","real-time",{"name":1824,"slug":1825,"type":15},"Storage","storage","2026-07-12T08:13:37.101253",{"slug":1828,"name":1828,"fn":1829,"description":1830,"org":1831,"tags":1832,"stars":1695,"repoUrl":1696,"updatedAt":1846},"cosmosdb-best-practices","optimize Azure Cosmos DB performance","Azure Cosmos DB performance optimization and best practices guidelines for NoSQL,\npartitioning, queries, SDK usage, and vector search. Use when writing, reviewing,\nor refactoring code that interacts with Azure Cosmos DB, designing data models,\noptimizing queries, or implementing high-performance database operations.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1833,1836,1839,1840,1843],{"name":1834,"slug":1835,"type":15},"Azure","azure",{"name":1837,"slug":1838,"type":15},"Cosmos DB","cosmos-db",{"name":1709,"slug":1710,"type":15},{"name":1841,"slug":1842,"type":15},"NoSQL","nosql",{"name":1844,"slug":1845,"type":15},"Performance","performance","2026-07-12T08:13:54.531719",{"slug":1848,"name":1848,"fn":1849,"description":1850,"org":1851,"tags":1852,"stars":1695,"repoUrl":1696,"updatedAt":1859},"data-analyst","analyze ClickHouse analytics data","Act as an interactive data analyst for ClickHouse-backed analytics. Use when the user asks questions about internal data, metrics, dashboards, telemetry, active users, revenue, funnels, trends, distributions, or wants an analyst-style conversation, ad hoc SQL, charts, or a data export against ClickHouse (local or ClickHouse Cloud).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1853,1854,1855,1858],{"name":1725,"slug":1726,"type":15},{"name":1728,"slug":1729,"type":15},{"name":1856,"slug":1857,"type":15},"Dashboards","dashboards",{"name":1731,"slug":1732,"type":15},"2026-07-12T08:13:31.975246",{"slug":1861,"name":1861,"fn":1862,"description":1863,"org":1864,"tags":1865,"stars":1695,"repoUrl":1696,"updatedAt":1872},"dataproc-skills","manage Dataproc clusters and jobs","Skills to interact with your Dataproc clusters and jobs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1866,1869],{"name":1867,"slug":1868,"type":15},"Data Engineering","data-engineering",{"name":1870,"slug":1871,"type":15},"Operations","operations","2026-07-12T08:13:42.179275",45]