> ## 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.

# FAQ

> Common questions about Charlie, including daemon behavior.

## Daemons FAQ

<Accordion title="What does daemon mean in Charlie?">
  A daemon is a repo-defined operating role for recurring work. It is not a long-running OS process.
</Accordion>

<Accordion title="Where is a daemon defined?">
  Each daemon is defined in a file at:

  <code>.agents/daemons/\<daemon-id>/DAEMON.md</code>
</Accordion>

<Accordion title="What is watch vs schedule?">
  <strong>watch</strong> wakes a daemon from matching events.

  <strong>schedule</strong> wakes a daemon on a cron timetable.

  A daemon can use either one or both.
</Accordion>

<Accordion title="What wake sources are supported?">
  Daemons can wake from scheduled cron wakes through <code>schedule</code>, plus routed GitHub, Linear, and Slack events through <code>watch</code>.

  Linear event wakes require the Linear integration to be connected and the issue's Linear team mapped to the intended repo. Slack event wakes require the Slack integration to be connected and the Slack workspace mapped to the intended repo.
</Accordion>

<Accordion title="What timezone does daemon cron use?">
  Cron schedules are evaluated in <strong>UTC</strong>.
</Accordion>

<Accordion title="Are daemon activations bounded?">
  Yes. Activations are bounded runs with explicit start/end, tool limits, and normal permission constraints.
</Accordion>

<Accordion title="Do daemons keep memory across activations?">
  Daemons can use prior activation history as context, but they do not run as a permanently active process.
</Accordion>

<Accordion title="Which DAEMON.md frontmatter fields are canonical?">
  Use only the canonical fields:

  <code>id</code>, <code>purpose</code>, <code>watch</code>, <code>routines</code>, <code>deny</code>, and <code>schedule</code>.

  Do not invent alternate top-level schema keys for activation mode.
</Accordion>

## General FAQ

<Accordion title="What languages does Charlie support?">
  Charlie is strongest in TypeScript and supports many common languages/frameworks used in modern repositories.
</Accordion>

<Accordion title="How quickly does Charlie review PRs?">
  Small and medium PRs are typically reviewed in minutes. Complex PRs can take longer when deeper validation is needed.
</Accordion>

<Accordion title="What should I do if Charlie is not responding?">
  Check installation scope, invocation method, and permissions first. Then use the [Troubleshooting](/troubleshooting) checklist.
</Accordion>

<Accordion title="Can Charlie review code written by humans and other agents?">
  Yes. Charlie is useful for both human-authored and agent-authored pull requests.
</Accordion>

<Accordion title="Can Charlie read screenshots/images?">
  Charlie can analyze images attached in supported surfaces and use them as task context.
</Accordion>

<Accordion title="Where do I get support?">
  Email <a href="mailto:support@charlielabs.ai">[support@charlielabs.ai](mailto:support@charlielabs.ai)</a>.
</Accordion>