# Alien Reminder by Incuv8or — setup prompt

Copy everything in the box below and paste it into Claude Code. That's the whole job —
Claude does the building and tells you what to click.

---

I've downloaded a folder of Swift source code for a small Mac app called **Alien Reminder
by Incuv8or**. It puts a little alien in my menu bar who flies a saucer across my screen a
few minutes before each meeting starts. Please build it and get it running on my Mac.

I am not a developer. Explain what you're doing in plain English, don't assume I know the
technical words, and if something fails, diagnose it and tell me exactly what to click.

Please do this in order:

1. **Check my Mac can build it.** It needs macOS 14 (Sonoma) or newer. Run
   `sw_vers -productVersion` to check, and tell me if I'm too old. Then run
   `swift --version`. If that fails, tell me to run `xcode-select --install`, wait for the
   download to finish, and then carry on. Don't make me install the whole of Xcode unless
   the build actually fails without it.

2. **Build it.** From inside the folder, run `./scripts/build-app.sh`. If it errors, read
   the error and fix it — don't just hand me the error message.

3. **Open the app.** It lives in the `build` folder and is called
   *Alien Reminder by Incuv8or.app*. There's no window and no Dock icon; it's a 👽 in the
   menu bar at the top right of my screen. Tell me to look for it.

4. **Calendar permission.** macOS will ask for access to my calendar. Tell me to click
   **Allow**, and explain that the app reads my meetings from the Calendar app and can't do
   anything at all without this. If I've already said no by accident, walk me through
   System Settings › Privacy & Security › Calendars.

5. **Prove it works.** Tell me to press **Control-Option-Command-A**. An alien should fly
   in from the left, pop up out of the saucer, show a speech bubble, and zip off to the
   right. If nothing happens, work out why.

6. **Set it up with me.** Open 👽 → Settings… and walk me through:
   - which calendars to watch (they're grouped by account, so I can untick a client's)
   - how many minutes' warning I want
   - the alien's size, and whether its colours rotate
   - whether it should open at login

7. **Tell me the two shortcuts** worth remembering: `⌃⌥⌘A` to test it, `⌃⌥⌘X` to dismiss a
   reminder that's on screen.

If I ask you to change how it looks — different colours, a bigger alien, a different
message — the colours live in `Sources/AlienHUD/Palette.swift` and the animation in
`Sources/AlienHUD/Alien.swift`. Change them, rebuild, and show me.

---

## Things worth knowing

- **It reads the Calendar app, not Google directly.** Whatever is in Calendar on your Mac
  is what it sees — iCloud, Google accounts you've added, even a ClickUp or Notion feed
  you've subscribed to. Add the account in System Settings › Internet Accounts and it
  appears in the app's calendar list.
- **It never asks for a password, an API key or a login.** There's nothing to connect and
  nothing to leak.
- **Rebuilding resets the Calendar permission.** That's macOS being careful, not a bug.
  Click Allow again.
- **It needs macOS 14 or newer**, and Claude Code needs a paid Claude plan.
