ihme

ihme

iCloud Hide My Email from the terminal.

ihme is a command-line tool for iCloud Hide My Email. It makes an address for a signup, finds it again by label, and turns it off when you are done with it. It also exports your addresses to CSV or JSON.

ihme new github.com          # Apple offers a few addresses, you pick one
ihme list --search github    # find it by label, address, or note
ihme deactivate github.com   # stop the mail
ihme export -o backup.csv    # keep your own copy

It works three ways. By hand: run a command, pick an address. From a script: every command takes --json. Through an agent: the built-in assistant runs on your own model key or on a coding agent you already use. It asks before it changes anything in your account.

You need iCloud+ and an Apple ID with two-factor authentication. Apple has no public API for this. ihme uses the same web API as icloud.com, and Apple can change it or block it. That is the deal.

Install

macOS on Apple Silicon:

curl -fL https://github.com/lroolle/ihme-cli/releases/latest/download/ihme_macOS_arm64.tar.gz -o ihme.tar.gz
tar -xzf ihme.tar.gz ihme
sudo install -m 755 ihme /usr/local/bin/ihme

Builds for macOS Intel, Linux, and Windows, on arm64 and x86-64, are on the releases page with SHA-256 checksums. With Go: go install github.com/lroolle/ihme-cli/cmd/ihme@latest.

Then sign in:

ihme auth login    # Apple ID, password, 2FA code. The session is saved, the password and code are not.
ihme list

Docs