Skip to main content
API Preview
Developers

Install on macOS (Homebrew)

Install ~alter’s always-on daemon on macOS via Homebrew. The Formula wraps the prebuilt alter-runtime release binary and registers a launchd plist named com.truealter.alter-runtime.

What you get

  • •alter-runtime binary on $PATH.
  • •launchd plist com.truealter.alter-runtime.
  • •Default config root at ~/Library/Application Support/alter/. Runtime socket falls back to the macOS DARWIN_USER_DIR when $XDG_RUNTIME_DIR is unset.

Install

Not published yet

The alter-runtime Formula is not in the tap yet, so brew install alter-runtime below will fail today. Until it ships, install the daemon with pip install alter-runtime instead. The tap itself is live, but today it carries only the alter CLI Formula (see below).

Once published, the Formula will ship from the official tap at true-alter/homebrew-tap. Tap once, then install:

bash
brew tap true-alter/tap
brew install alter-runtime

Need the CLI too? The alter CLI is on the same tap today: brew install true-alter/tap/alter, or via npm. See the npm install guide for details.

Start the daemon

bash
brew services start alter-runtime

Verify

bash
alter-runtime --version
brew services info alter-runtime

Cross-platform unity

However a person installs alter-runtime, the runtime they get is the same runtime everyone else gets: same socket protocol, same ~handle resolution, same DNS-TXT discovery, same federation endpoints. macOS uses launchd rather than systemd; the plist is a local-idiom optimisation, not a substrate divergence. A macOS user federates with users on any other channel identically.

Next steps

Getting started

Bind a ~handle and make your first authenticated request.

~handle protocol

How ~handle resolution works on top of the running daemon.

Docs | ~alter