> For the complete documentation index, see [llms.txt](https://docs.desktop.faros.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.desktop.faros.ai/troubleshooting/solve-common-problems.md).

# Solve Common Problems

## No Sessions Appear

1. Check the selected date range, provider, search, and filters.
2. Confirm the tool is enabled in **Settings → General → AI tools**.
3. Check whether Faros is checking, reading, or analyzing history.
4. Review directory access and any macOS permission guidance.
5. If the tool has no local sessions yet, start a session there and return to Faros.

An enabled provider can appear in a filter even when it has no activity in the selected period.

## Faros Cannot Reach Agent

Check the background-service status in **Settings → Advanced → App**. If macOS approval is required, open **System Settings → General → Login Items & Extensions** and follow the app's guidance. Use the connection notice's recovery action, then refresh.

Run the installed app from Applications rather than the mounted disk image.

## Analysis or Figures Look Incomplete

Let the initial index finish. Review coverage captions and retry a failed refresh. Summaries, task classifications, and mood readings can lag the activity.

Check scope before comparing totals. Account limits use provider windows, while activity uses your selected range. Tool spend is an allocation of model spend; it excludes MCP service charges. Estimated spend can differ from billing.

## A Power Up is Unavailable

Open its details for prerequisites: setup, sign-in, a model/runtime, supported host, or organization permission. Installed, enabled, and ready are different states.

If Faros Desktop says the Agent cannot support the action yet, it means you need to update to a compatible release.

## Team Activity is Missing

Check the Semaphore server and sign-in. Verify that your account has access and that the expected updates have been shared.

## Related Guides

* [Updates and Support](/troubleshooting/updates-and-support.md)
* [Configure Faros](/settings-and-privacy/configure-faros.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.desktop.faros.ai/troubleshooting/solve-common-problems.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.