Install takes about two minutes. The beta isn’t signed by Apple yet, so the first launch needs one extra step. This page shows both ways to do it.
What you need
- A Mac with Apple Silicon (M1 or later) and macOS 12 Monterey or newer.
- Projects you already deploy from your terminal, for example with
npm run deployorwrangler deploy.
1. Download and install
- Download Ploink.dmg (122 MB) from GitHub Releases.
- Open the DMG and drag Ploink onto the Applications folder.
- Optional: check the download against the SHA-256 in the release notes.
shasum -a 256 ~/Downloads/Ploink.dmg
2. Open the unsigned beta the first time
The beta isn’t signed or notarized yet, because Ploink doesn’t have an Apple developer account yet. macOS blocks unsigned apps on the first launch. You only do this once. Every launch after that is a normal double-click.
macOS 14 Sonoma and earlier: right-click, then Open
- In Finder, open Applications.
- Right-click (or Control-click) Ploink and choose Open.
- In the warning, click Open again.
macOS 15 Sequoia and later: Open Anyway
Apple removed the right-click shortcut in macOS 15, so use System Settings instead.
- Double-click Ploink in Applications. macOS says it can’t verify the app. Click Done.
- Open System Settings › Privacy & Security and scroll down to Security.
- Next to “Ploink was blocked to protect your Mac”, click Open Anyway, then confirm with your password or Touch ID.
- Click Open in the last dialog.
Or from Terminal
This removes the download flag from the app, which has the same effect:
xattr -dr com.apple.quarantine /Applications/Ploink.appNot comfortable opening an unsigned app? Build it from source instead. The signed, notarized build is coming by 31 January 2027.
3. Add your first project
- Drag a project folder onto the Ploink window, or click + in the top bar. Ploink reads
package.json, Wrangler, Fly, Vercel, Netlify and Makefile setups to find the deploy command, and fetches the site’s icon. - Hold the project’s button for about 0.65 seconds. The LED ring charges, then your deploy command runs in your own login shell, with live output on the readout.
- Press F5 (fn + F5 on most Mac keyboards) in any app to bring up the launch bar. Hold a number key, or type part of a project’s name and hold Return.
4. Connect your coding agent (optional)
Ploink runs an MCP server on 127.0.0.1:47321 while it’s open. Each agent needs its own token: Settings › Agents (MCP) › Create token. Settings then shows the setup line for that agent. For Claude Code it looks like this:
claude mcp add --transport http --scope user ploink http://127.0.0.1:47321/mcp --header "Authorization: Bearer plk_…"Agents can only press buttons you set up, and you can make any deploy wait until you hold the glowing button yourself. More clients are covered in the README.
5. Unlock Ploink Pro (founding members)
Click the LED ring button in the top bar to open Button packs, then Unlock. Paste the license key from your Gumroad receipt, or the founder code from your founder page.
Updating and uninstalling
- Update: download the new DMG and drag Ploink to Applications again. Your projects and settings stay. Every release is listed in the changelog.
- Uninstall: quit Ploink, delete it from Applications, and delete
~/Library/Application Support/Ploinkto remove your projects, settings and history.
Build from source
The core app is MIT-licensed. You need Node.js and npm (Node 22 works).
git clone https://github.com/petarjs/ploink.git
cd ploink
npm install
npm startBuilds from source include everything except the Ploink Pro packs.
Stuck?
Email hey@ploink.dev or open an issue on GitHub.