# Apple Shortcuts

Shortcuts allows you to run any shortcut using a [X-Callback-URL](/inbox-ai/integrations/x-callback-url.md) with the following format: `shortcuts://x-callback-url/run-shortcut?name={{ name | percentEncode }}&input=text&text={{ input | percentEncode }}`

In the "Other" folder there is a pre-built example to run an Apple Shortcut called "Run Apple Shortcut". 

You can add this action to any AI command and teach it to run specific Shortcuts, or duplicate it and change it to run a specific Shortcut. The latter option is more likely to have the correct results.

<figure><img src="/files/HFAhnRw0SV1AySS5ehlD" alt=""><figcaption></figcaption></figure>

Note that you can use [Action Variables](/inbox-ai/actions/action-variables.md) in the URL to give your AI more options.

## Alternative approach

You can also run shortcuts using the shortcuts terminal command like this, with the benefit of having their output available for a next action.

```bash
echo "{{ text | doubleQuoteEscape }}" > {{ dir.tmp }}/{{run.id}}
echo $(shortcuts run "{{ shortcut | doubleQuoteEscape }}" -i {{ dir.tmp }}/{{run.id}})
rm {{ dir.tmp }}/{{run.id}}
```


---

# Agent Instructions: 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:

```
GET https://dreetje-1.gitbook.io/inbox-ai/integrations/apple-shortcuts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.