Amp for macOS

Requires Apple silicon and macOS 26 or later.

Open the disk image and drag Amp into Applications.

The app checks for updates on its own. To check right away, choose Check for Updates… from the Amp menu.

The Amp app on a MacBook Pro, with the thread sidebar beside an open thread and suggested replies above the composer

To install with Homebrew instead, run:

brew install --cask ampcode/tap/amp@beta

Threads and Orbs

Everything you can do in Amp works in the app. Start threads that run in orbs or on your runners, including this Mac.

Puck

By default, Puck opens in the sidebar. To open it in a window of its own instead, set Open Puck to In Separate Window in the app’s Settings > General. You can put that window beside your work or on another display. It reads the page your main window is showing, so you can still say “this thread” or “this project”. A thread or any other page you open from Puck gets its own window, leaving the chat where it is. Either way, right-click Puck in the sidebar and choose Open in Separate Window or Dock in Sidebar to open it in that place.

To open one Puck conversation in a window like any other thread, right-click it in Puck’s list and choose Open in New Window.

See Meet Puck for what to ask.

The app adds a Dictate to Puck shortcut to the Shortcuts app. It opens Puck and starts dictation. Add it to a keyboard shortcut, or run it through Siri. The app also adds a Call Puck shortcut that opens Puck and starts a call. The call runs in the Amp window like it does on ampcode.com.

Share an image to Amp from any app’s share sheet. Add a message if you want, then send. The image goes to Puck, which can start an agent, open a thread, or answer a question about it.

Notifications

The app notifies you when a thread is ready for your next message. Click the notification to open the thread.

Turn notifications on or off for this Mac with Allow Notifications in App Settings… > General. Choose which notifications your account gets, and whether to skip them while you are active in Amp, in your notification settings. The thread you are viewing never sends a notification.

Open Threads from Links

Thread links (https://ampcode.com/threads/...) that you click in another app, such as Slack, Mail, or Notes, open in the Mac app once you have launched the app at least once. A link also opens in the app when you click it in Safari on another site.

Links you click in Chrome, or click or type while you are already on ampcode.com, reach your browser instead. The first time a thread link from outside Amp does on a Mac, the thread page asks whether to open threads in the Mac app:

Open in Mac App sends this thread to the app, keeps the browser tab, and asks again next time.
Always Open in Mac App sends this thread and every later thread link straight to the app.
Dismissing the question keeps threads in the browser.

The choice is saved on your account, so every Mac browser you are signed in to follows it. Change it any time with Open Threads in the Mac App in Settings > Appearance, in the browser or in the app.

With it on, a thread link from outside Amp never shows the thread in the browser. The tab shows Opening in the Amp App instead and closes once the app, signed in to the same account, shows the thread. If the browser asks whether to allow opening Amp, answer it first. When the app does not open within a few seconds, because it is not installed, the question was cancelled, or it is signed in to another account, the page says so and offers Open in Browser, Download Amp for Mac, and Stop Opening in App, which turns the setting off. Links you open inside Amp, reloads, and threads the app sends back to the browser stay in the browser. Chrome lets a page open another app once per click in Chrome, so when you open several thread links in a row without clicking in Chrome, the later ones stop on that page; click Open in Browser or open the thread from the app.

To send one thread to the app without changing the setting, click Open in Mac App in the thread header. The browser tab keeps the thread. Safari also offers Open in the Amp app and Chrome Open in app in the address bar while a thread page is open.

Windows and Menus