> For the complete documentation index, see [llms.txt](https://perceptdot.gitbook.io/perceptdot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://perceptdot.gitbook.io/perceptdot/usage.md).

# How to Use

Just talk to your AI naturally. No special syntax needed.

***

## Basic usage

```
Check my site for bugs: https://mysite.com
```

```
Any layout issues on https://shop.example.com?
```

***

## Check on mobile or tablet

```
Check https://mysite.com on mobile
```

```
Any issues on https://mysite.com on tablet viewport?
```

Supported viewports: **desktop** (1280px, default) · **tablet** (768px) · **mobile** (375px)

***

## Force a fresh scan (bypass cache)

```
Re-check https://mysite.com — ignore cache
```

Cached results return in \~0.3s. Use `no_cache: true` after a fix to see the latest state.

***

## Example output

```
✅ No visual issues detected on https://example.com

No layout bugs, overflow issues, or clipped elements found.

Full-page scan complete — 3 tiles analyzed (desktop) in 4.2s
Cost: $0.000620 | Credits used: 3
```

```
⚠️ Visual issues detected on https://mysite.com

Summary: Two layout issues found in hero and footer sections.

Issues:
  [HIGH] CTA button overflows container by 18px (section-hero)
  [MED]  Footer text is clipped at narrow widths

Full-page scan complete — 5 tiles analyzed (desktop) in 9.8s
Cost: $0.001033 | Credits used: 5
```

***

## Useful phrases

| What to say               | What it does                  |
| ------------------------- | ----------------------------- |
| "Check this URL"          | Full-page desktop scan        |
| "Check on mobile"         | Full-page mobile scan (375px) |
| "Check on tablet"         | Full-page tablet scan (768px) |
| "Re-check with no\_cache" | Bypass cache, fresh scan      |
| "Any bugs?"               | Reports issues only           |

***

## Send feedback to unlock extra credits

After a scan, tell your AI:

```
That result was accurate — send feedback
```

```
That was a false positive — send feedback
```

Your AI uses the `percept_feedback` tool to submit the rating. **Accurate feedback earns bonus credits** and helps improve detection quality.

***

## Good to know

{% hint style="info" %}
**What's a tile?**\
perceptdot splits pages into 1280×1600px sections for analysis.\
Short pages = 1 tile. Long pages = multiple tiles.\
**1 tile = 1 credit used.** The output always shows how many tiles were scanned.
{% endhint %}


---

# 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://perceptdot.gitbook.io/perceptdot/usage.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.