ihme
iCloud Hide My Email from the terminal. One address per signup. Find it later. Deactivate when done.
ihme new github.com # pick from Apple's candidates
ihme list --search github # by label, address, or note
ihme list --sort date:asc # oldest first, to clean up
ihme deactivate # no address: pick one, newest first
ihme share netflix # grant read of that address
ihme export -o backup.csv # your own copy
Needs iCloud+ and an Apple ID with 2FA. Unofficial: ihme uses the same web API as icloud.com. Apple can change it or block it.
中文
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
macOS Intel, Linux, Windows (arm64, x86-64): releases, with SHA-256 checksums. Go: go install github.com/lroolle/ihme-cli/cmd/ihme@latest.
ihme auth login # Apple ID, password, 2FA. Saves session, not password or code.
ihme list
Scripts
Every address command takes --json. --jq runs installed jq on it. No prompts without a terminal.
ihme new github.com --json # candidates only, reserves nothing
ihme new github.com --address <candidate> --json # reserve one
ihme new github.com --yes --json # reserve the first
ihme list --json --jq '.addresses[].hme'
Exit 2: sign in again. Exit 1: anything else.
Share one inbox
ihme share netflix # prints a key and a link, once
ihme serve # http://127.0.0.1:8025
The key opens one address's mail: INBOX and Junk, last 30 days, as plain text. No other address, no other recipients, nothing loaded from anywhere else. The server reads mail over IMAP with an app-specific password, never your iCloud session. ihme share revoke netflix ends it. Details.
Agents
ihme agent "find my github address": built-in assistant on your model key (Anthropic, DeepSeek, any OpenAI-compatible endpoint).ihme agent --via codex "find my github address": a coding agent you are already signed in to. Also claude, opencode. No API key.npx skills add lroolle/ihme-cli -g: the skill for an outside agent. ihme mcp: a stdio MCP server.
Account changes ask first. Preferences live in plain Markdown; ihme memory shows them. An agent run sends the task and results to the model you picked. Plain commands never talk to a model.
Docs
- Commands: search, create, edit, tags, share, export, JSON, errors
- FAQ: signed in but Hide My Email refuses, no 2FA code, cleaning up old addresses
- Agents: providers, consent, memory, MCP
- Roadmap and release notes
- Security: what is stored, and where
- Contributing
Development
make check # vet, test, build
make site # website into _site/
Built with Cobra and Charm. MIT. Not affiliated with Apple.
