{"_id":"@amxv/icloud-cli","_rev":"2-d22abe72abf92132a21f85f4984f652a","name":"@amxv/icloud-cli","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@amxv/icloud-cli","version":"0.1.0","keywords":["go","cli","template","npm","release"],"author":{"name":"amxv"},"license":"Apache-2.0","_id":"@amxv/icloud-cli@0.1.0","maintainers":[{"name":"amxv","email":"a@ashray.xyz"}],"homepage":"https://icloud-cli.vercel.app","bugs":{"url":"https://github.com/amxv/icloud-cli/issues"},"bin":{"icloud-cli":"bin/icloud-cli.js"},"dist":{"shasum":"72823722fe9ec26ab2bea7b871575f7b8306a7ad","tarball":"https://registry.npmjs.org/@amxv/icloud-cli/-/icloud-cli-0.1.0.tgz","fileCount":14,"integrity":"sha512-OmOvYMta+E2urjCaWTW2dnSd44WqFhW370w8MzzbkZ4hnP+vSotVypzI/EOyqEV4fwn7MtO6zDNZ8RZcUDC88A==","signatures":[{"sig":"MEUCIQDZbXKtGkwoUPxbr5KJ71iz97oszz+xAV9mVKzDc5HwKwIgLinAPsGj6iH82zKJQv9NE7ulzCbjyBbvZIqTuN6ngwo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35253},"config":{"cliName":"icloud-cli","goModule":"github.com/amxv/icloud-cli","cliBinaryName":"icloud"},"engines":{"node":">=18"},"gitHead":"2bf55d1a4f68c8d49391fa32bd59f2c1447120c8","scripts":{"lint":"npm run test","test":"node --check bin/icloud-cli.js && node --check scripts/postinstall.js && node --check scripts/project.js && node --check scripts/setup.js","docs:dev":"astro dev","docs:build":"astro build","docs:check":"astro check","postinstall":"node scripts/postinstall.js","docs:preview":"astro preview"},"_npmUser":{"name":"amxv","email":"a@ashray.xyz"},"repository":{"url":"git+https://github.com/amxv/icloud-cli.git","type":"git"},"_npmVersion":"10.9.8","description":"A CLI for interacting with iCloud","directories":{},"_nodeVersion":"22.23.1","_hasShrinkwrap":false,"devDependencies":{"astro":"^7.0.3","zuedocs":"0.1.25","typescript":"^5.9.2","@types/node":"^24.0.13","@astrojs/check":"^0.9.4"},"_npmOperationalInternal":{"tmp":"tmp/icloud-cli_0.1.0_1785952869853_0.8034156536455672","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@amxv/icloud-cli","version":"0.2.0","description":"A command-line interface for iCloud, starting with a comprehensive iCloud Mail client","packageManager":"bun@1.3.14","license":"Apache-2.0","author":{"name":"amxv"},"repository":{"type":"git","url":"git+https://github.com/amxv/icloud-cli.git"},"homepage":"https://icloud.ashray.xyz","bugs":{"url":"https://github.com/amxv/icloud-cli/issues"},"bin":{"icloud":"bin/icloud.js"},"man":["man/icloud.1"],"config":{"cliName":"icloud","cliBinaryName":"icloud","goModule":"github.com/amxv/icloud-cli"},"scripts":{"postinstall":"node scripts/postinstall.js","test":"node --check bin/icloud.js && node --check scripts/postinstall.js && node --check scripts/release-metadata.js && node --check scripts/package-install-smoke.js && node --test scripts/packaging.test.js scripts/docs-contract.test.js","lint":"npm run test","docs:dev":"astro dev","docs:build":"astro build","docs:preview":"astro preview","docs:check":"astro check"},"engines":{"node":">=18"},"keywords":["cli","icloud","apple","mail","email","imap","smtp","automation"],"devDependencies":{"@astrojs/check":"^0.9.4","@types/node":"^24.0.13","astro":"^7.0.3","typescript":"^5.9.2","zuedocs":"0.1.26"},"_id":"@amxv/icloud-cli@0.2.0","gitHead":"c5e237f7831912336d965cf845da23815a1ab5f6","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-hVi+Cp6RWpdnZbWXx4dTuh0/DKNCyAGMr6U1AEFG4m8lL+Is1TDKJ+TvTVTdQAAnbocfKqVrXB1pmC62TEfrAw==","shasum":"6850517a6390aa027171359f318dd9c63a0621cf","tarball":"https://registry.npmjs.org/@amxv/icloud-cli/-/icloud-cli-0.2.0.tgz","fileCount":486,"unpackedSize":3214608,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC+C8zTNOpyUy6nKL/Wgyri9rKw6j0FNgULPYTZ/PgACgIgaELIBuGsl0m21ubNdyBhqf2+QbMCEFnxsxR2vP8iYK4="}]},"_npmUser":{"name":"amxv","email":"a@ashray.xyz"},"directories":{},"maintainers":[{"name":"amxv","email":"a@ashray.xyz"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/icloud-cli_0.2.0_1786470518267_0.3531077613635558"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-05T18:00:56.609Z","modified":"2026-08-11T17:48:38.549Z","0.1.0":"2026-08-05T18:01:10.013Z","0.2.0":"2026-08-11T17:48:38.424Z"},"bugs":{"url":"https://github.com/amxv/icloud-cli/issues"},"author":{"name":"amxv"},"license":"Apache-2.0","homepage":"https://icloud.ashray.xyz","keywords":["cli","icloud","apple","mail","email","imap","smtp","automation"],"repository":{"type":"git","url":"git+https://github.com/amxv/icloud-cli.git"},"description":"A command-line interface for iCloud, starting with a comprehensive iCloud Mail client","maintainers":[{"name":"amxv","email":"a@ashray.xyz"}],"readme":"# icloud\n\n`icloud` is a command-line interface for Apple's iCloud ecosystem. **iCloud Mail is the comprehensive service today**: read, search, synchronize, draft, send, reply, organize, import, export, secure, and automate your mailbox from one predictable command tree.\n\nThe project is designed to grow beyond Mail over time. Contacts, Reminders, Calendar, and other iCloud services can live under the same `icloud` command as they become implemented and reliable.\n\n## Install\n\n```bash\nnpm install --global @amxv/icloud-cli@latest\nicloud version\n```\n\n## Get started\n\nUse an Apple **app-specific password**, not your normal Apple Account password:\n\n```bash\nicloud account add --name Personal --email you@icloud.com\nicloud account test Personal\nicloud mail folders refresh\nicloud mail sync\nicloud mail messages list\n```\n\nSearch locally:\n\n```bash\nicloud mail search invoice\n```\n\nRead one selected message:\n\n```bash\nicloud mail message show msg_… --full\n```\n\nPreview a reply before sending it:\n\n```bash\nicloud mail reply msg_… --body-file reply.txt --dry-run\n```\n\nThen send the reviewed reply with a stable idempotency key:\n\n```bash\nicloud mail reply msg_… \\\n  --body-file reply.txt \\\n  --idempotency-key reply-01 \\\n  --yes\n```\n\nThe [Quickstart](https://icloud.ashray.xyz/docs/quickstart) walks through the full first-use flow.\n\n## Mail today\n\nThe current CLI includes:\n\n- multiple iCloud Mail accounts and safe credential sources;\n- folder discovery, current sync, foreground watch, and historical backfill;\n- local search plus explicit fresh provider search;\n- messages, conversations, attachments, and exact EML access;\n- drafts, send, reply, reply-all, forward, aliases, and signatures;\n- read/flag state, move/copy, archive, trash, junk, restore, and delete;\n- reviewed bulk actions and bounded empty-folder workflows;\n- mailbox and EML import/export;\n- mailing-list unsubscribe and local VIP/blocked sender preferences;\n- S/MIME inspection, decryption, signing, and encryption;\n- outbound operation history and safe-retry Outbox recovery;\n- compact text, JSON, JSONL, strict request schemas, completion, and man pages.\n\nCheck the exact feature set of the binary you installed with:\n\n```bash\nicloud capabilities\nicloud capabilities --json\n```\n\n## Built for agents too\n\nNormal output is compact so an agent can explore without pulling full message bodies into context. Stable IDs such as `msg_…`, `thr_…`, `att_…`, and `drf_…` make multi-step workflows easy to compose.\n\n```bash\nicloud mail search invoice\nicloud mail message show msg_… --full\nicloud mail attachments list msg_…\nicloud mail reply msg_… --body-file reply.txt --dry-run\n```\n\nUse `--json` when you need structured parsing, `--jsonl` for event streams or per-item results, and `--no-input` to prevent implicit prompts in automation.\n\nSee the [Agent guide](https://icloud.ashray.xyz/docs/agent-guide) and [Automation recipes](https://icloud.ashray.xyz/docs/automation-recipes).\n\n## Documentation\n\nThe documentation is organized around user tasks rather than implementation details:\n\n- [What is icloud?](https://icloud.ashray.xyz/docs/what-is-icloud)\n- [Quickstart](https://icloud.ashray.xyz/docs/quickstart)\n- [Mail guides](https://icloud.ashray.xyz/docs)\n- [Supported features](https://icloud.ashray.xyz/docs/supported-features)\n- [Command reference](https://icloud.ashray.xyz/docs/command-reference)\n- [Troubleshooting](https://icloud.ashray.xyz/docs/troubleshooting)\n\nRaw Markdown is available from `/docs.md` and each guide's `.md` route for agent-friendly retrieval.\n\n## Project direction\n\nMail is the first complete command family, not the intended limit of the project. The top-level `icloud` command leaves room for additional iCloud services without pretending they already exist. The installed command tree and `icloud capabilities` remain the source of truth for what is available in a particular release.\n\n## Development\n\nPrerequisites: Go 1.26.5+, Node.js 18+, and Bun 1+ for the docs site.\n\n```bash\nmake references\nmake check\nmake build-all\nmake docs-check\nmake docs-build\n```\n\n`make references` regenerates schemas, the exhaustive command reference, man pages, and shell completion from the current CLI sources.\n\n## License\n\nApache 2.0\n","readmeFilename":"README.md"}