> For the complete documentation index, see [llms.txt](https://help.refractbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.refractbot.com/general-setup/logs.md).

# Logs

Refract has two kinds of logs: task logs you view in the bot, and dev log files in the app data folder. For checking what a task did, task logs are the ones you want.

## Task logs: right-click the task

Right-click any task and click **View Logs**. This is the user-facing log: it shows what that task has been doing, in a readable format. When troubleshooting a task or asked for logs in a ticket, this is the log to check.

## Dev logs: the app data folder

Refract also writes log files to its app data folder on your machine.

{% hint style="warning" %}
**App data logs are not user friendly, and they are not designed to be.** A lot of things are missing from them. They exist for our development team, not for users, so do not try to troubleshoot from them. Your logs are the right-click **View Logs** on a task. Only dig out the app data files if support asks you for them.
{% endhint %}

If support does ask, here is where the folder lives:

{% tabs %}
{% tab title="Windows" %}

1. Press **Win + R** to open the Run box.
2. Type `%appdata%` and press Enter.
3. You land in `AppData\Roaming`. Open the **Refract** folder.

Or in File Explorer: click the address bar, type `%appdata%`, press Enter, and open the **Refract** folder.
{% endtab %}

{% tab title="Mac" %}

1. Open **Finder** (or click the desktop so Finder is active).
2. Press **Cmd + Shift + G** to open the Go to Folder box.
3. Type `~/Library/Application Support` and press Enter.
4. Open the **Refract** folder.

Or from the Finder menu bar: click **Go**, then **Go to Folder...**, and enter the same path.
{% endtab %}
{% endtabs %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.refractbot.com/general-setup/logs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.