About ask-cli
ask-cli is a command-line tool for querying App StoreKit APIs, aimed at developers managing in-app purchases and transaction data. It covers products, subscriptions, transactions, entitlements, notifications, and events.
Key features
- 01Manage in-app purchase products
- 02Inspect subscriptions and groups
- 03Review and verify transactions
- 04Query customer status and entitlements
- 05List notifications and events
Use cases
- 01Check a product's history for an app
- 02Verify or refund a transaction
- 03Review a customer's subscription status
- 04Inspect recent notifications or events
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ dl-alexandre/ skills --skill ask-cliAfter installing, type/ask-cliin Claude Code to confirm it loaded.
Details
From the project READMEApp StoreKit CLI
Query App StoreKit APIs using the ask command-line tool.
Prerequisites
ask --version
export ASK_ISSUER_ID='your-issuer-id'
export ASK_PRIVATE_KEY_PATH='/path/to/key.p8'
ask auth status
Authentication
- Issuer ID and private key from App Store Connect
- Environment variables:
ASK_ISSUER_ID,ASK_PRIVATE_KEY_PATH - Or:
ask auth loginfor interactive setup
In-App Purchases
Products
ask products list --app APP_ID
ask products get PRODUCT_ID --app APP_ID
ask products history --app APP_ID --product PRODUCT_ID
Subscriptions
ask subscriptions list --app APP_ID
ask subscriptions get SUBSCRIPTION_ID --app APP_ID
ask subscriptions groups list --app APP_ID
ask subscriptions status --app APP_ID --customer CUSTOMER_ID
Transactions
ask transactions history --app APP_ID --customer CUSTOMER_ID
ask transactions verify --app APP_ID --transaction-id TX_ID
ask transactions refund --app APP_ID --transaction-id TX_ID --reason "Customer request"
Consumption & Status
ask consumption report --app APP_ID --date 2024-06-01
ask status --app APP_ID --customer CUSTOMER_ID --product PRODUCT_ID
ask entitlements --app APP_ID --customer CUSTOMER_ID
Notifications & Events
ask notifications list --app APP_ID --days 7
ask events list --app APP_ID --type SUBSCRIBED --days 30
Agent Best Practices
- Customer IDs: Use anonymized identifiers
- Pagination: Use
--cursorfor large result sets - Date ranges: Limit queries to needed timeframe
- Sandbox: Use
--sandboxfor testing environment
Comments
Markdown supported