Omacookie

Omacookie etching a fortune in the Omarchy bar

Omacookie is a fortune cookie that lives entirely in the Omarchy bar. Click the icon and a small popup drops down under it. Click the cookie and it bursts into crumbs that arc away under gravity, then a laser cuts your fortune into the empty slip: a beam angles down from above onto the paper, tracks across the sentence throwing sparks, and each character burns into existence where the beam touches it and cools from hot yellow to ember to ink. Nothing slides in — the letters are cut in place.

Both animations are modelled on the ttfx effects the Omarchy screensaver uses: crumble for the cookie's dust glyphs and dimming, and laseretch for the beam, the sparks, and the cooling ramp. No new window ever opens.

It has no network, account, or telemetry. Fortunes are a bundled, original list shipped in the plugin itself. It uses the Python 3 runtime included with Omarchy to safely load its small state file.

Install

omarchy plugin add https://github.com/doctor/omacookie.git --enable

Then click the cookie in the Omarchy bar. Omacookie is a bar widget with no overlay or panel surface, so there is nothing to summon from the CLI — the bar icon is the whole entry point. If you don't see it, check that it's enabled and placed:

omarchy plugin list | grep omacookie
omarchy bar move io.github.doctor.omacookie --section right

Controls

Click the bar icon: open or close the popup
Click the cookie: crack it open and reveal your fortune
Click anywhere outside the popup: dismiss it

Reopening the popup always starts fresh with a whole cookie and a new fortune. There are 200 fortunes, and the last 30 you were shown are held back from the draw, so you won't see the same one twice in a sitting. That short history and a running "cookies cracked" count are stored in ${XDG_STATE_HOME:-~/.local/state}/omacookie/state.json.

Update and remove

omarchy plugin update io.github.doctor.omacookie
omarchy plugin remove io.github.doctor.omacookie

Removing the plugin does not remove its small state file. Delete that file manually if you also want to reset the cracked-cookie count.

Development

node --test
npm run assets     # regenerate assets/crack.wav
omarchy plugin validate .

Plugins run as unsandboxed code inside the long-lived Omarchy shell. Review the source before enabling third-party plugins. Omacookie writes only its state file and invokes no privileged or network commands.