> 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/updates-and-support.md).

# Updates and Support

## Update Faros Desktop

Use the update controls in **Settings → General → Updates** when available. Your organization's policy can restrict manual checks, automatic checks, downloads, or updates entirely.

If updates are centrally managed, use the installation supplied by your administrator. For a manual disk-image update, replace the installed app with the supplied copy and reopen it.

The Desktop release bundles its Agent and Helper. On reopening, Faros reconciles those background components. Follow any approval or active-session guidance shown rather than repeatedly replacing the app.

## Check the Installed Version

Use **Settings → General → About** to find the Desktop build. Include that identity when reporting a problem. A newer Desktop feature may also require the matching Agent capability.

## Prepare a Support Report

1. Reproduce the problem and note the screen and action.
2. Use **Feedback** from the Faros Desktop menu, or **Prompt to debug** where an error offers it.
3. Describe what you expected and what happened.
4. Generate the support prompt, review it, and edit as needed.
5. Copy it to the support destination or coding assistant you intend to use.

Faros can draft this prompt locally with Apple Foundation Models when available, with a fallback when they are not. It includes relevant build and diagnostic information and redacts common sensitive details.

Generating a prompt does not send it automatically. Review the text before sharing, especially if you added session content or other sensitive context yourself.

## Additional Update and Support Entry Points

You can also access and configure updates via **Faros Desktop Toolbar > Check for Updates** and **Settings > General > Install updates automatically**. These are only available if your organization policy allows them.

For additional help, contact your designated Faros FDE with the reviewed support prompt, Desktop build, Agent version, expected result, and observed result.

## Remove Faros Desktop

To uninstall Faros Desktop, perform the following steps:

1. Quit Faros Desktop and Faros Helper.
2. Move the app from Applications to the Trash.
3. Confirm Faros no longer appears in **System Settings → General → Login Items & Extensions**.

Removing the app *does not* delete locally stored Faros data or your AI tools' session history.

## Related Guides

* [Solve Common Problems](/troubleshooting/solve-common-problems.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/updates-and-support.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.