How majd/ipatool works
ipatool is a CLI for authenticating with Apple’s App Store, discovering apps and versions, managing licenses and purchases, and downloading iOS-family or macOS packages. The main workflow uses an authenticated account to find or identify an app, optionally acquire its license, then download its package. The repository also exposes MCP tools for app-store operations. The graph preserves documented command capabilities; several implementation links for unsampled commands and subsystems are documented-level rather than source-verified.
Main entry points: appstore App Store client · main.go CLI entry · client.go HTTP client · appstore_login.go Authentication
Components 23
CLI and MCP
- CLI entry
main.go - Auth commands
cmd/auth.go - Search command
cmd/search.go - Download command
cmd/download.go - Other commands
cmd - MCP tools
cmd/mcp_tools.go
Account and Catalog
- App Store client
pkg/appstore - Authentication
pkg/appstore/appstore_login.go - App search
pkg/appstore/appstore_search.go - Owned apps
pkg/appstore/appstore_owned_apps.go - Version metadata
pkg/appstore - App lookup
pkg/appstore
Licensing and Downloads
- License purchase
pkg/appstore - Package download
pkg/appstore/appstore_download_product.go
SAP Signing Runtime
- SAP action signer
internal/sap/signer_local.go - SAP guest machine
internal/sap/machine/machine.go - Mach-O images
internal/sap/machimage/image.go - Emulation engine
internal/sap/unicorn/engine.go
State and Transport
- HTTP client
pkg/http/client.go - Credential keychain
pkg/keychain/keychain.go - CLI dependencies and state
cmd/common.go
Other components
- User
- Apple App Store
Connections 29
- User → CLI entry: runs
main.go - CLI entry → Auth commands: dispatches
- CLI entry → Search command: dispatches
- CLI entry → Download command: dispatches
- CLI entry → Other commands: dispatches
main.go - CLI entry → MCP tools: serves tools
- Auth commands → App Store client: calls
cmd/auth.go - Search command → App Store client: queries
cmd/search.go - Download command → App Store client: requests download
cmd/download.go - Other commands → App Store client: provides operations
cmd/auth.go - MCP tools → App Store client: invokes operations
cmd/mcp_tools.go - App Store client → Apple App Store: uses App Store
- App Store client → Authentication: implements
- App Store client → App search: implements
- App Store client → Owned apps: implements
- App Store client → Version metadata: provides
- App Store client → App lookup: provides
- App Store client → License purchase: provides
- App Store client → Package download: implements
- Authentication → HTTP client: sends requests
pkg/appstore/appstore_login.go - App search → HTTP client: sends requests
pkg/appstore/appstore_search.go - Owned apps → HTTP client: sends requests
pkg/appstore/appstore_owned_apps.go - Package download → HTTP client: uses transport
pkg/appstore/appstore_download_product.go - Authentication → SAP action signer: creates signer
- SAP action signer → SAP guest machine: uses guest
internal/sap/signer_local.go - SAP guest machine → Mach-O images: opens images
internal/sap/machine/machine.go - SAP guest machine → Emulation engine: runs guest code
internal/sap/machine/machine.go - CLI dependencies and state → Credential keychain: configures
cmd/common.go - CLI dependencies and state → App Store client: constructs client
cmd/common.go