# Siphon > Siphon turns the Action Button on Apple Watch Ultra into a direct line to your AI agent. Press it and talk: your words appear live on the watch and on your Mac, go to your agent (Hermes today), and come back as a short reply on your wrist and a thread on your Mac. Speech-to-text runs on the Mac. If you're an agent setting Siphon up for someone: install the Mac app as "Install" says, then follow the [Quickstart](https://siphon.watch/docs/quickstart.md) in order. Run each check before moving on, and stop and hand over to the person at the steps marked [You]. Every docs page is also plain Markdown: add `.md` to its address. ## Key facts - Siphon is in early testing. The Mac app is a public download. The watch app is still built from source, which is private: without access to it, the Mac app installs and runs, and the Quickstart stops at "Get the source" (waitlist: https://siphon.watch/#waitlist). - It needs a Mac with Apple silicon running macOS 26 or later, an Apple Watch Ultra with watchOS 26 or later paired with an iPhone, and an agent on the Mac: Hermes, Claude Code or Codex. Siphon uses the first one that answers; nothing to configure when Claude Code or Codex is signed in. - The current Mac app is 0.1.0-1027: https://download.siphon.watch/Siphon-0.1.0-1027.dmg (SHA-256 `c0f3b4480d707607d6dcab508d6de4887ed1fc8bef3f72e45a28484e4acd6b71`), signed with Siphon's Developer ID (team 3V94DAXZ2J) and notarized by Apple. Once installed it updates itself. - No account is needed at home: the Mac app, speech-to-text on the Mac, pairing the watch over the home network, captures, replies and threads all work with nothing signed in. - An account on siphon.watch with an active plan (a subscription, or free access) is needed only for the relay: reaching the Mac away from home, and notifications when the agent replies. It can be added later with no pairing again. - You make that account, or sign in to it, from the terminal: ask the person for their email address (never guess it), run `account sign-up --email ` ("Commands" below), and Siphon emails them a 6-digit code. They read it to you, you run `account verify `, and the Mac is signed in. A new account has no plan yet: the command says so and gives the account page's address. If it says the server can't email a code yet, `relay sign-in` does the same through the browser. - Steps only the person can do: getting the watch ready (Developer Mode, Xcode signed in), comparing the 6-digit pairing code on the watch and the Mac, macOS's Local Network and Login Items prompts, reading you the 6-digit code Siphon emails them when signing in to the relay (or pressing the button in that email, or approving the Mac in the browser), setting the Action Button, and the first capture. - On the Mac, Siphon.app runs a background agent and a server on `127.0.0.1:8787` (they start at login, with no window). The first start downloads the speech model, about 600 MB. Logs are in `~/Library/Logs/Siphon`. - Never print the server's token (`~/.local/share/siphon/token`) or an agent's API key. ## Install Two ways, both checked. With Homebrew, which checks the download's SHA-256 and leaves Gatekeeper to check the notarization: ```sh brew install --cask counterbeing/siphon/siphon open /Applications/Siphon.app ``` Or step by step. This block is the whole install: it works out the machine, reads the release list for the current version (none is written here), checks the download's SHA-256, checks that the disk image and the app are signed by Siphon's team and notarized, then installs and opens Siphon.app. Run it as one command; it stops at the first step that fails, and on a machine Siphon doesn't run on it says so in one line and installs nothing. It's safe to run again. `SIPHON_APPS_DIR` installs somewhere other than /Applications. ```sh ( set -eu # 1. This machine. Siphon runs on a Mac with Apple silicon and macOS 26 or later. if [ "$(uname -s)" != Darwin ]; then echo "Not supported: there is no Siphon for $(uname -s) yet. It needs a Mac with Apple silicon and macOS 26 or later." >&2 exit 1 elif [ "$(sysctl -n hw.optional.arm64 2>/dev/null)" != 1 ]; then echo "Not supported: Siphon needs a Mac with Apple silicon. This one has an Intel processor." >&2 exit 1 elif ! [ "$(sw_vers -productVersion | cut -d. -f1)" -ge 26 ] 2>/dev/null; then echo "Not supported: Siphon needs macOS 26 or later. This Mac has macOS $(sw_vers -productVersion)." >&2 exit 1 fi platform=mac # 2. The current release for this platform: its version, its file name, its SHA-256. work=$(mktemp -d) cd "$work" curl -fsS -o latest.json "https://download.siphon.watch/latest-$platform.json" version=$(plutil -extract version raw -o - latest.json) file=$(plutil -extract file raw -o - latest.json) sha256=$(plutil -extract sha256 raw -o - latest.json) echo "Installing Siphon $version" # 3. Download that file from the same place, and check it is the one the release list names. curl -fsS -o Siphon.dmg "https://download.siphon.watch/$file" echo "$sha256 Siphon.dmg" | shasum -a 256 -c # 4. Check it is Siphon's: signed with Siphon's Developer ID (team 3V94DAXZ2J) and notarized # by Apple. The disk image first, then the app copied out of it. signed='anchor apple generic and certificate 1[field.1.2.840.113635.100.6.2.6] exists and certificate leaf[field.1.2.840.113635.100.6.1.13] exists and certificate leaf[subject.OU] = "3V94DAXZ2J" and notarized' codesign --verify --strict --check-notarization --test-requirement="=$signed" Siphon.dmg mkdir image hdiutil attach -nobrowse -readonly -noautoopen -mountpoint image Siphon.dmg >/dev/null 2>&1 || diskutil image attach --mountOptions nobrowse --readOnly --mountPoint image Siphon.dmg >/dev/null ditto image/Siphon.app Siphon.app hdiutil detach -quiet image 2>/dev/null || diskutil eject image >/dev/null codesign --verify --strict --deep --check-notarization --test-requirement="=identifier \"watch.siphon.desktop\" and $signed" Siphon.app # (Build attestation: when Siphon's releases carry one, the command that checks it goes here.) # 5. Install it and open it. A copy that is already there is replaced; quit it first. apps=${SIPHON_APPS_DIR:-/Applications} osascript -e 'quit app "Siphon"' 2>/dev/null || true rm -rf "$apps/Siphon.app" ditto Siphon.app "$apps/Siphon.app" open "$apps/Siphon.app" cd / && rm -rf "$work" ) ``` ## Commands ```sh brew install --cask counterbeing/siphon/siphon # install the Mac app (or the block above) curl -fsS https://download.siphon.watch/latest-mac.json # the current release: version, file, SHA-256 curl -s http://127.0.0.1:8787/health # is Siphon's server answering? spctl -a -vv /Applications/Siphon.app # accepted, source=Notarized Developer ID tail -n 50 ~/Library/Logs/Siphon/agent.log # the background agent; "update:" lines are the updater tail -n 50 ~/Library/Logs/Siphon/server.log # the server: captures, speech-to-text, replies ``` An account for the relay, with the person's own address and then the code they read you from the email (the Quickstart's "Connect the relay"): ```sh cd /Applications/Siphon.app/Contents/MacOS ./siphon-desktop account sign-up --email you@example.com # emails them a 6-digit code; makes the account if there's none ./siphon-desktop account verify 123456 # their code; with no code, after they press Add this Mac in the email ./siphon-desktop status # who is signed in, the connection, and whether the relay needs a plan ``` ## Docs - [What Siphon is](https://siphon.watch/docs/overview.md): Voice capture from Apple Watch Ultra to the AI agent on your Mac. What it does, how the pieces fit, and what it needs. - [Quickstart](https://siphon.watch/docs/quickstart.md): Set Siphon up on a Mac and an Apple Watch Ultra, from the Mac app download and the watch app's source. Written so a coding agent can run it step by step. - [Troubleshooting](https://siphon.watch/docs/troubleshooting.md): Fixes for the common ways a Siphon setup goes wrong, with the commands to check each one. - [Privacy policy](https://siphon.watch/docs/privacy.md): What Siphon keeps on your devices, what the hosted relay and account service see, the daily usage counts and how to turn them off, crash reports, and who else is involved. - [Hand off a task](https://siphon.watch/docs/t3-handoff.md): Review a Siphon brief, copy Markdown, or start an explicit task in a named T3 Code target. ## Optional - [All docs in one file](https://siphon.watch/llms-full.txt): every page above, inline - [Website](https://siphon.watch/): the product page, and the waitlist at https://siphon.watch/#waitlist