> ## Documentation Index
> Fetch the complete documentation index at: https://docs.charlielabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# How It Works

> Charlie’s runtime model, execution flow, and operating boundaries.

To learn more about how daemons work, please read [How Daemons Work](https://charlielabs.ai/how-it-works).

To learn more about how Charlie works generally, please read about [CAOS, the Coding Agent Operating System](https://charlielabs.ai/blog/charlie-v2-introducing-the-coding-agent-operating-system-caos/).

## Multi-surface wake model

Charlie can start work from routed events on the systems your team already uses:

* GitHub events such as mentions, review requests, assignments, and PR activity
* Linear events such as issue creation, issue comments of any kind on mapped issues, issue mentions, and issues assigned to Charlie
* Slack events such as mentions, thread replies, channel messages, and DMs
* daemon `schedule` entries for cron-based wakes

For daemon `watch` conditions, GitHub events route through the repo-scoped GitHub App installation. Linear events require a connected Linear workspace and the event issue's Linear team mapped to the repo where the daemon lives. Slack events require a connected Slack workspace mapped to that repo. Use [Daemons](/daemons) for wake model details and [Integrations](/integrations) for setup.

<img src="https://mintcdn.com/charlie-7b05a877/P2gKdIthisivTuht/images/how-it-works-visual-overview.svg?fit=max&auto=format&n=P2gKdIthisivTuht&q=85&s=01bcda88d31b62a6770f8d538b3a1523" alt="Charlie run lifecycle visual overview" width="1400" height="560" data-path="images/how-it-works-visual-overview.svg" />
