packages

Packages Overview

This directory is the single documentation source for package-level responsibilities.

Package	Primary responsibility	Typical consumers	Internal deps
`@cline/shared`	Cross-package shared primitives (path resolution, session common types, indexing helpers)	`@cline/agents`, `@cline/core`, apps	None
`@cline/llms`	Model catalog + provider settings schema + handler creation SDK	`@cline/agents`, `@cline/core`, apps	None
`@cline/agents`	Stateless agent runtime loop (tools, hooks, extensions, teams, streaming)	`@cline/core`, apps	`@cline/llms`, `@cline/shared`
`@cline/core`	Stateful runtime orchestration (runtime composition, session lifecycle/storage, local and hub runtime services, hub discovery and client helpers)	CLI/Desktop apps	`@cline/agents`, `@cline/llms`, `@cline/shared`
`@cline/ui`	Internal framework-neutral web theme, Tailwind adapter, and optional base styles	Cline web apps	None

@cline/llms defines model/provider capabilities and builds concrete handlers.
@cline/agents runs the agent loop on top of those handlers and tool execution primitives.
@cline/core composes runtime behavior with persistent sessions/storage and local or hub-backed runtime services.
@cline/core hub services orchestrate scheduled runtime execution, execution history, and schedule command handling.
@cline/core/hub exposes discovery, the detached hub daemon, and session-oriented client APIs (HubSessionClient, HubUIClient) when hosts need a shared daemon.
@cline/shared provides the shared contracts and path/session primitives used across the stack.

Put provider/model schema, cataloging, and handler wiring in @cline/llms.
Put loop/tool/hook/team execution behavior in @cline/agents.
Put persistence, session lifecycle, and runtime assembly in @cline/core.
Put scheduled execution and schedule persistence in @cline/core hub services.
Put hub discovery, attach flows, and session-oriented client adapters in @cline/core/hub.
Put cross-package utility types and path/session constants in @cline/shared.
Put remote-config schemas, materialization, telemetry normalization, and blob upload primitives in @cline/shared/remote-config.
Put shared web tokens and visual foundations in @cline/ui; keep fonts, shell layout, and product-specific animation with each consuming app.

Node-oriented imports exist where packages expose a distinct Node alias.
@cline/core itself is now the Node/runtime-oriented entry point for host/session services.
Browser entry points still exist in packages that intentionally publish a browser surface, but @cline/core no longer does.

Nested package README.md and ARCHITECTURE.md files can be reduced or removed after references are updated to point here.