Cline Architecture DissectedReading the source top-down

A learning site that dismantles the cline/cline VSCode AI coding extension layer by layer. Every step links directly to the corresponding source lines on GitHub, pinned to tag v4.0.10.

Start reading →

Agent loop

Tool system

GitHub repository

Top-down

From the extension entry point activate → Controller → the Task main loop → the tool system → Provider → prompts and modes → MCP / sub-agents, expanded layer by layer.

Source navigation

Every key file carries a SrcLink — click it to land on the exact lines on GitHub. Version is pinned to v4.0.10; upgrading means changing one place.

Real code inlined

Not just pointers — 5-15 lines of real TypeScript source for key functions are pasted directly into the page, with Chinese commentary before and after explaining what is happening.

Design motivation and boundaries

Each page covers not only responsibilities but also why the design is this way, plus how edge cases and failure modes are handled.

Recursive agent loop

Cline's core is the Task class driving the LLM stream → parse → tool execution → feedback loop recursively via recursivelyMakeClineRequests, stringing together an entire turn.

Reuses official docs

This site focuses on architectural dissection and source navigation. For installation and usage, see the official docs — we don't duplicate them.