A dock with your AI built in

Petal replaces the dock on your Mac or on Omarchy. Your own Claude Code or Codex lives in it, so you change anything by asking, and on the Mac you can hand it work from a sticky note.

Download for Mac Install on Omarchy

Free and open source. For macOS 26 or later, and Omarchy 4.5 or later.

On this window

@Petal put these receipts in a table

Done. Nine receipts, newest first.

Change anything by asking

The button at the start of the dock opens a chat with your own Claude Code or Codex. It knows how Petal works, so you say what you want and it's done. When a setting can't do it, it can change Petal's own code, and Petal keeps your change through every update.

Look: “Make the dock darker.” “Bigger icons.”
Behaviour: “Stop the icons from bouncing.” “Move the dock to the left.”
Apps: “Put my browser first.” “Add GitHub as a shortcut.”
Usage: A ring around the button fills as you use your plan. Hover it to see what's left.

Sticky notes that can do things

On the Mac, Petal Notes are your own writing on paper, stuck where it matters. Drag one off the dock and let it go anywhere. It comes back whenever that place does.

They stick to things: A sentence, a browser tab, a window, an app, a file, a person you're chatting with, or the screen itself.
They do things: Write @Petal and what you want, then press Return. It works in the background and the answer comes back as ink on the note.
They come back: “Bring this back Friday.” “Check this every morning.” A note takes its instructions in plain words.
They read with you: Open a PDF, a document or a deck in Petal's viewer and your notes sit in the margin beside the passage.
They're yours: Each note is a Markdown file and each notebook a folder, in your iCloud Drive.

An AI that works in your apps

On the Mac, Petal AI sees what's in front of you and can use your apps for you. It asks before it changes anything, and you can stop it at any moment.

Its own pointer: It presses, types and chooses menus with a pink pointer of its own. Yours never moves.
It asks first: Anything that changes something shows a card: Allow, Always or Don't.
A vault: It logs in, fills forms and checks out with what you saved, without ever seeing a password, a card number or a key.
Routines: “Keep my Downloads tidy.” Describe it once and Petal does it by itself. Files are moved, never deleted.
Your other agents: Claude Code or Codex in a terminal can use the vault too, once you allow it for a project.

On Omarchy, a mode for every workspace

Each workspace remembers its mode, and each mode has its own apps. Move between workspaces and the dock changes with you.

Focus modes: Building, Writing, Social, or any you ask for: “Add a Gaming mode with Steam and Discord.”
Focus cards: Open something that belongs to a distracting mode and a small card asks: stay, or go there.
Held notifications: Notifications from outside your mode wait on their own mode, with a count. One that can't wait finds you.

And a good dock

Everything a dock should do, on both.

Badges and progress: Unread counts on icons, one bounce when an app needs you, and a ring around a download.
Windows: Hover an app to see its windows. Minimized ones wait in the dock as thumbnails.
Files: Drop files on an app to open them there. Folders open as stacks, newest first.
Websites: Any address can sit in the dock as a shortcut, with the site's own icon.
Every screen: One dock per screen, with now playing, and auto-hide when you want the room.

Good to know

Is Petal free?

Yes, and open source under the MIT license. There are no accounts, servers or analytics.

Do I need an AI subscription?

No. The dock works whole without one. With Claude Code or Codex installed and signed in, Petal uses your own plan, and on the Mac you can use your own API key instead.

What leaves my computer?

Petal sends nothing anywhere by itself. What you ask the AI, and what it looks at to answer, goes to it through your own Claude Code or Codex. Passwords, card numbers and keys in the vault stay in your Mac's Keychain and are never shown to the AI.

Why does macOS say it can't check Petal?

Petal isn't signed with an Apple Developer ID. Open the download once, then go to System Settings, Privacy & Security, and choose Open Anyway. Installing with the one line in a terminal skips this step.

What does Petal ask for on the Mac?

Accessibility, to see your windows and to use apps when you ask it to, and Screen Recording, for window previews. It gives your own Dock back whenever you quit it.

How do updates work?

Petal checks GitHub for a new version now and then and gets it ready. It restarts only when you say so.

What do I need?

A Mac with macOS 26 or later, or Omarchy 4.5 or later. Petal isn't planned for Windows.

Get Petal

Free and open source. It keeps itself up to date.

For Mac

macOS 26 or later. Petal takes the place of your Dock, and gives it back when you quit.

Download for Mac

For Omarchy

Omarchy 4.5 or later. Petal plugs into Omarchy's shell, so there's nothing else to install.

Download for Omarchy

Or install it on either with one line in a terminal.

curl -fsSL https://petal-dock.vercel.app/install.sh | bash