Documentation.
A technical, high-level tour of how Chalie works — the runtime, memory and cognition, the message loop, tools, and how other agents talk to it. For setup and day-to-day use, see the Guide.
Architecture Overview
The runtime that turns a message into action — the core components, the provider layer, and how the pieces fit together.
Memory & Cognition
How Chalie remembers and thinks between turns — the memory layers, recall at turn start, decay, and the background cognition loop.
Message Flow
What happens between a user message and a reply — the turn lifecycle, the act loop, tool calls, and compaction.
Threads
How a reply becomes a thread — the turn model, auto-generated labels, per-thread context and thinking mode, and the REST surface that drives it.
Ambient Awareness
How Chalie stays aware of the world — the world-state snapshot and the background services that feed it into every turn.
Tools & Abilities
How Chalie acts — the ability model, tool discovery, the result contract, dispatch, and permission gating.
Agent & MCP Integration
How other agents and tools connect to Chalie over MCP, and how Chalie talks to external MCP servers.