---
title: "Troubleshooting"
description: "Start with the failing step, preserve your draft, and check the result before retrying."
locale: "en"
canonical: "https://orylo.io/en/docs/troubleshooting"
product_status: "in-development"
last_reviewed: "2026-10-12"
---

# Troubleshooting

Start with the failing step, preserve your draft, and check the result before retrying.

<a id="assistant"></a>

## The Assistant connects but cannot answer

1. **Test the source** — For a local Agent, make one request in its own CLI or client. Check its sign-in, API credentials, subscription, and quota there.
2. **Recheck in Orylo** — Open the Assistant’s settings, inspect the failure reason, and rerun the check after fixing the source. Verify the configured model and options.
3. **Use a small request** — Try plain text without attachments. Add the original context back gradually to distinguish a connection failure from an unsupported input or size limit.

<a id="capture"></a>

## Selection, screenshots, or voice are missing

- Confirm automatic selection capture is enabled if that is the feature you expect; it is off by default.
- Check the relevant macOS permission and retry from the source app. Clipboard content is not a fallback for an unreadable selection.
- For speech, verify the explicitly chosen engine, supported language, and downloaded Whisper model. Orylo does not silently switch engines.
- For OCR, verify the global switch and Assistant image preference. Review the original image when extraction fails.

<a id="schedule"></a>

## A scheduled task did not run

Check that Orylo was running, the Mac was awake, the schedule was enabled, and its timezone and next run were correct. Inspect run history for a failed attempt before starting another.

Missed runs are skipped by default. Pausing future triggers does not stop an already active run.

<a id="access"></a>

## Sign-in or device access is blocked

Confirm the same Apple or Google identity is used on the website and Mac. Check trial or purchase status and the active device list, then use Refresh access in the app.

At the activation limit, deactivating a Mac does not restore a consumed activation in the rolling window. Follow the account page’s available actions and timing.

<a id="support"></a>

## Ask for help safely

Use [Feedback](https://orylo.io/en/feedback) or email support@orylo.io with the operation, visible error, app/macOS version, and concise reproduction steps. Feedback submission on the website requires sign-in.

Do not include tokens, API keys, private prompts, or confidential attachments. If a side-effecting task may already have completed, inspect its result before retrying it.

## Continue exploring

- [Connect an Assistant](https://orylo.io/en/docs/assistants)
- [Permissions & control](https://orylo.io/en/docs/permissions)
- [Account & devices](https://orylo.io/en/docs/account)