# ihme

> A command-line tool for iCloud Hide My Email: list, create, edit, deactivate, and export alias addresses. Includes JSON output, an agent skill, a built-in assistant, and a stdio MCP server. MIT licensed.

Requires iCloud+ and interactive Apple ID sign-in with 2FA. Install a release binary or run `go install github.com/lroolle/ihme-cli/cmd/ihme@latest`, then `ihme auth login`. Installing the agent skill does not install the binary. This is an unofficial client of Apple's undocumented web API.

The live index is https://lroolle.github.io/ihme-cli/llms.txt; the mapped documents are available together at https://lroolle.github.io/ihme-cli/llms-full.txt. `--jq` requires a local jq executable. Use `new --json` to generate without reserving, then `--address` to reserve. Exit codes are 0 for success, 1 for other errors, and 2 when authentication is required. Agent mode sends task context and tool results to the selected provider.

## Start here

- [README](README.md): what it does, install, scripts, agents
- [README, Chinese](README.zh.md): the same, in Chinese
- [Command guide](docs/usage.md): search, create, edit, tags, lifecycle, exports, JSON, and errors
- [Agent guide](docs/agents.md): providers, coding agents, consent, preferences, memory, and MCP
- [SKILL.md](skill/SKILL.md): the operational procedure both external agents (shell) and the embedded agent follow — including the address taste rubric
- [ROADMAP](ROADMAP.md): what shipped per version and what's planned

## Using it as an agent

- [AGENTS.md](AGENTS.md): command reference for agents that read agents.md
- [pkg/agentkit](pkg/agentkit/README.md): the stdlib-only, embeddable agent kernel it runs on — reusable outside this CLI

## Health

- [LICENSE](LICENSE): MIT
- [SECURITY.md](SECURITY.md): what's stored, what isn't, how to report an issue
- [Contributing](CONTRIBUTING.md): bug reports, local checks, and website maintenance