feat: initial commit, add shortcuts

Author: twilsonco

README.md

@@ -1,2 +1,96 @@
 # SiriShortcuts
-A list of Siri Shortcuts (macOS/iOS/iPadOS) that I've made
+
+## 1. ChatGPT
+
+### A. [I have a question](https://www.icloud.com/shortcuts/e01b052c382d44e09631dd5ba4a22e2d) 🔗
+
+* Starts a voice-only conversation with ChatGPT using the ChatGPT iOS/iPadOS app (does not work on macOS)
+* Using the ChatGPT app has the following advantages
+  * A paid ChatGPT Plus account is optional, but you'll need at least a free ChatGPT account
+  * If you do have a ChatGPT Plus subscription, you can optionally use GPT4 as the model
+  * ChatGPT will remember previous messages as you continue your conversation
+* You can specify initial and followup system prompts in order to better control ChatGPT's behavior (as well as setup "custom instructions" in the ChatGPT app)
+* When run from lock screen, dictation of your prompt to ChatGPT will end automatically when a pause is detected
+* When run while unlocked, dictation will continue until you press the stop button ⏹️
+* Shortcut can be modified to use OpenAI or ElevenLabs TTS by replacing the "Speak Text" action with "Run Shortcut" pointing to (2A) or (2B) below
+
+#### Known issues
+
+* The Shortcut may complain that you are not logged into the ChatGPT app, even though you are
+  * The workaround is to simply rerun the Shortcut, which will work on subsequent runs
+  * Every Shortcut using the ChatGPT app may have this same issue
+  * Please let me know if you find a reliable solution for this; I've tried including a very short use of the "Ask ChatGPT" action so that its later use will always succeed, but any failure of the action causes the Shortcut to fail, so this approach doesn't work
+
+### B. [I want to have a conversation](https://www.icloud.com/shortcuts/bd154f690837417cb81ede56f71448dc) 🔗
+
+* Similar to (1), but unlocks phone first in order to avoid some issues that happen on the lock screen (does not work on macOS)
+* Uses OpenAI TTS to read back response in a more natural voice (needs "Speak text with OpenAI" (2A) shortcut installed)
+* Can modify shortcut to use ElevenLabs TTS for reading back response if desired, or to use iOS built-in TTS
+
+### C. [Weather summary](https://www.icloud.com/shortcuts/5c29fe42940a4275a7a4e92fac90dde8) 🔗
+
+* Fetches weather data for your current location and have ChatGPT read back a natural language summary of the upcoming weather
+* Uses the ChatGPT app like (1), so does not work on macOS
+
+### D. [Today's agenda and weather](https://www.icloud.com/shortcuts/4f4f10b2306844ac8526f86aef32cbf6) 🔗
+
+* Define a list of iOS calendars which are used to fetch your scheduled events for the day, and have ChatGPT read back a summary of your agenda
+* Uses the ChatGPT app like (1), so does not work on macOS
+
+### E. [ChatGPT via API](https://www.icloud.com/shortcuts/9aed05675a574bd385f73e4d5b77a9da) 🔗
+
+* Drop-in replacement for the ChatGPT app's "Ask ChatGPT" Shortcut action
+* Provide text as input and use the OpenAI API to submit the text to ChatGPT as a prompt
+* If run with no input, the Shortcut will ask for text input
+* Requires your own [OpenAI API key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-api-key) 🔗
+* This does not provide any back-and-forth conversation capability, and only provides a basic example of how to use the OpenAI API for interacting with ChatGPT
+  * For back-and-forth conversation, you would need to give ChatGPT "memory" by including previous messages, both yours and ChatGPT's responses, in the `messages` array in the Dictionary that is passed to the "Get contents of URL" action.
+  * This functionality would need to be added by you (please PR an improved shortcut if you make one ;) )
+  * This method of "memory" will quickly increase the cost of using this shortcut, as the number of tokens in each API call will grow with each subsequent call
+  * For this reason it is preferable, in my opinion, to use the ChatGPT app as in the above shortcuts so that OpenAI's own internal method of "memory" is used, which has none of these drawbacks
+
+## 2. AI Text-to-speech (TTS)
+
+### A. [Speak text with OpenAI](https://www.icloud.com/shortcuts/1c4e5e9f26bc4a89a2bd6c6db24d0f3b) 🔗
+
+* Drop-in replacement for the "Speak Text" Shortcut action using OpenAI's TTS voices to speak the text
+* Falls back to using the "Speak Text" action if it fails
+* Requires your own [OpenAI API key](https://help.openai.com/en/articles/4936850-where-do-i-find-my-api-key) 🔗
+
+### B. [Speak text with ElevenLabs](https://www.icloud.com/shortcuts/2c24d1c527e347b1b8b4a3fed73f41fa) 🔗
+
+* Drop-in replacement for the "Speak Text" Shortcut action using ElevenLabs's TTS voices to speak the text
+* Falls back to using the "Speak Text" action if it fails
+* Requires your own [ElevenLabs API key](https://elevenlabs.io/docs/api-reference/authentication#) 🔗
+
+## 3. OpenPilot navigation shortcuts
+
+* OpenPilot is an after-market level-II autonomous driving product by [Comma.ai](https://comma.ai) 🔗
+* It can now perform nearly full navigation from origin to destination, stopping for lights/signs, and performing turns completely unassisted
+* These Shortcuts simplify the process of setting a navigation destination
+* See the [separate repository for the Shortcuts here](https://github.com/twilsonco/OpenPilotSiriShortcuts) 🔗
+
+## 4. Mobile Safari
+
+### A. Open in Chrome 🔗
+
+* Use the [share sheet](https://www.idownloadblog.com/2020/04/21/customize-share-sheet-iphone-ipad/) 🔗 in Safari on iOS/iPadOS to open the current website in the Google Chrome app
+
+## 5. macOS Shortcuts
+
+### A. Activate/deactivate head pointer
+
+* Two Shortcuts to activate or deactivate the [head pointer feature of macOS](https://support.apple.com/en-gb/guide/mac-help/mchlb2d4782b/mac#:~:text=Turn%20on%20and%20customize%20head%20pointer&text=Go%20to%20Motor%20on%20the%20right%2C%20then%20click%20Pointer%20Control.&text=Turn%20on%20“Head%20pointer.”,and%20which%20camera%20to%20use.) 🔗 that lets you move/click the mouse using the direction of your head and facial gestures
+* First, visit the head pointer settings to configure them to your liking
+* Install links:
+  * [Activate head pointer](https://www.icloud.com/shortcuts/adb89eacf53c4ecb957650e8d93df1a3) 🔗
+  * [Deactivate head pointer](https://www.icloud.com/shortcuts/8ea48a269ac84d02b6cbed5989ce1d3c) 🔗
+
+### B. Restart/shutdown Mac
+
+* With MacBooks with Touch ID, or when using the Magic Keyboard with Touch ID, the classic keyboard shortcuts to sleep/restart/shutdown a Mac or turn off the display no longer work
+* These two Shortcuts at least provide the ability to perform a restart or shutdown, per [my answer on Apple Stack Exchange](https://apple.stackexchange.com/a/464996/85762) 🔗
+* After installing, you'll need to setup keyboard shortcuts to trigger the shortcuts
+* Install links:
+  * [Restart Mac](https://www.icloud.com/shortcuts/92d8a4d8a11c4f21869e8a37180e8132) 🔗
+  * [Shutdown Mac](https://www.icloud.com/shortcuts/714cbb1e3ff642be86a356315955adcc) 🔗