Get started

Install wharfy, then hand it to your AI agent. That’s the whole setup — wharfy is built to be run by your assistant, not memorised by you.

Before you begin

• Homebrew (macOS), Scoop (Windows), or the install script (Linux) — to install wharfy
• a GitHub repo for your binary — wharfy publishes its release artifacts there
• the channels you want to own — a Homebrew tap, a Scoop bucket, a hosted apt/yum repo; set them up when you publish, not now

1. Install

macOS (Homebrew):

brew install shirodoromoto/wharfy/wharfy

Windows (Scoop):

scoop bucket add wharfy https://github.com/ShiroDoromoto/scoop-wharfy
scoop install wharfy

Linux:

curl -fsSL https://wharfy.io/install.sh | sh

2. Hand it to your AI

In your project, tell your assistant to run:

wharfy agent

That one command returns every command, its arguments, the order to use them in, and how to read the current state. Your AI reads it once and drives the release from there — build, sign, publish, verify.

What a release looks like

wharfy status     # where am I? (what's built / signed / published, and where)
wharfy build      # cross-compile for every os/arch     → next: sign | publish
wharfy publish    # push to owned channels; prepare gated → next: verify
wharfy verify     # install from each channel and run it

Every command also takes --json, and ends with a next: block — so neither you nor your AI has to remember the order.