App Store Connect CLI

Track sales, monitor reviews, and analyze performance
Built with Go for lightning-fast performance.

Get Started in 5 Minutes View Demo
Terminal 
$ pomme sales

📊 Fetching sales report for December 2024...

📊 Sales Report for December 2024
────────────────────────────────────────────────────────────

  📦 Total Units
  125,847

  💰 Revenue
  USD 486,392.45 (73.2% of total)
  EUR 124,836.20 (18.8%)
  JPY ¥693,450 (5.2%)
  GBP £15,234.89 (2.8%)

  🌍 Countries
  142 markets

Generated: 2024-12-15 09:23:41

Get Started in 5 Minutes

The interactive setup wizard makes configuration a breeze

1

Install Pomme

Choose your preferred installation method

# Arch Linux (AUR) - Recommended for Arch users
yay -S pomme
# or: paru -S pomme
# for development version: yay -S pomme-git

# Install with Homebrew (macOS)
brew tap marcusziade/tap
brew install pomme

# Or install with Go
go install github.com/marcusziade/pomme/cmd/pomme@latest

# Or download the latest binary
curl -L https://github.com/marcusziade/pomme/releases/latest/download/pomme_$(uname -s)_$(uname -m).tar.gz | tar xz
2

Run Setup Wizard

Let our interactive wizard guide you through configuration

pomme config init 
$ pomme config init

🍎 Welcome to Pomme Setup Wizard
────────────────────────────────────────────────────────────

This wizard will help you set up Pomme to work with your
App Store Connect account. You'll need:

  • An Apple Developer account
  • Admin or Account Holder role in App Store Connect
  • About 5 minutes to complete the setup

Ready to begin? [Y/n]: y

📋 Step 1: Create an API Key
────────────────────────────────────────────

1. Open https://appstoreconnect.apple.com/access/api
2. Click the + button to create a new key
3. Give it a name like "Pomme CLI"
4. Choose "Admin" access (or appropriate role)
5. Click "Generate"

Have you created the API key? [y/N]: y
3

Enter Your Credentials

The wizard helps you find and enter the right values

🔑

Key ID

10-character identifier (e.g., 73TT63DP5R)

🆔

Issuer ID

UUID from the Keys page

📄

Private Key

Path to your downloaded .p8 file

4

Automatic Validation

Pomme tests your configuration to ensure everything works

Validation 
🧪 Validating Configuration
────────────────────────────────────────

Checking config file... ✓
Checking credentials... ✓
Checking private key file... ✓
Testing API connection... ✓

✅ Configuration is valid!

You're all set to use Pomme. Try these commands:
  • pomme sales - View your sales reports
  • pomme apps list - List your apps

Setup Features

🎯

Interactive Wizard

Step-by-step guidance with clear instructions at every stage

🔍

Automatic Validation

Tests your credentials and connection before you start

🛡️

Secure Storage

Credentials stored safely in your home directory

📚

Built-in Help

Detailed instructions available with pomme config help

Configuration Commands

pomme config init Interactive setup wizard
pomme config show View current configuration
pomme config validate Test your credentials
pomme config help Detailed setup guide

Powerful Features

Everything you need to manage your App Store business

📊

Sales Reports

View monthly sales with multi-currency support, automatic USD conversion, and beautiful visualizations.

  • Monthly & daily reports
  • Multi-currency grouping
  • Period comparisons
  • CSV/JSON export
⭐

Review Management

Monitor customer reviews, analyze ratings, and respond to feedback across all territories.

  • List & filter reviews
  • Rating analytics
  • Territory breakdown
  • Quick responses
🚀

Performance

Built with Go for blazing-fast performance. Concurrent API calls and intelligent caching.

  • Go concurrency
  • Smart caching
  • Minimal dependencies
  • Cross-platform
🎨

Beautiful Output

Gorgeous terminal output with colors, emojis, and perfectly aligned tables.

  • Colored output
  • Progress indicators
  • Clean formatting
  • Export options

See It In Action

Real examples of Pomme's beautiful output

pomme sales monthly --details 
$ pomme sales monthly --details

📊 Fetching sales report for December 2024...

📊 Sales Report for December 2024
────────────────────────────────────────────────────────────

  📦 Total Units
  125,847

  💰 Revenue by Currency
  USD 486,392.45 (73.2% of total)
  EUR 124,836.20 (18.8%)
  JPY ¥693,450 (5.2%)
  GBP £15,234.89 (2.8%)

  💵 Total (USD equivalent)
  $664,321.93

  🌍 Countries
  142 markets

📱 App Performance
────────────────────────────────────────────────────────────

  App                         Units         Revenue  Top Markets
  ─────────────────────    ────────    ────────────  ─────────────────────
  Weather Pro                45,231    USD 180,924   USA, CAN, AUS
  Task Master                38,456    EUR 76,912    DEU, FRA, ITA
  Photo Editor Plus          22,890    USD 137,340   USA, GBR, JPN
  Meditation Daily           12,450    GBP 9,960     GBR, IRL, AUS
  Language Learning Pro       6,820    JPY ¥477,400  JPN, KOR, CHN

Generated: 2024-12-15 09:23:41
pomme sales compare 
$ pomme sales compare --current 2024-12 --previous 2024-11

📊 Comparing December 2024 vs November 2024...

📊 Sales Comparison
November 2024 vs December 2024
════════════════════════════════════════════════════════════

📈 Overall Performance
────────────────────────────────────────
  Units: 98,234 → 125,847 (+27,613, +28.1%) ↑
  
  Revenue Changes:
  USD: $378,923.12 → $486,392.45 (+$107,469.33, +28.4%) ↑
  EUR: €98,234.50 → €124,836.20 (+€26,601.70, +27.1%) ↑
  JPY: ¥523,100 → ¥693,450 (+¥170,350, +32.6%) ↑
  GBP: £12,456.23 → £15,234.89 (+£2,778.66, +22.3%) ↑

📱 App Performance
────────────────────────────────────────
  Weather Pro:      32,456 → 45,231 (+39.4%) ↑
  Task Master:      29,123 → 38,456 (+32.1%) ↑
  Photo Editor:     22,890 → 22,890 (0.0%) →
  Meditation:       10,234 → 12,450 (+21.7%) ↑
  Language Pro:      3,531 →  6,820 (+93.1%) ↑

🎯 Key Insights
────────────────────────────────────────
  • Strong holiday season performance
  • Language Learning Pro doubled its sales
  • All major markets showed growth
  • Japanese market growth outpaced others

Generated: 2024-12-15 09:24:15
pomme reviews list 
$ pomme reviews list 123456789

📱 Fetching reviews for app 123456789...

📱 Customer Reviews
────────────────────────────────────────────────────────────────────────────────

⭐⭐⭐⭐⭐ TechEnthusiast  USA                   2024-12-14
Best weather app I've ever used!
The UI is gorgeous and the forecasts are incredibly accurate. The widget 
is perfect and updates in real-time. Worth every penny!
────────────────────────────────────

⭐⭐⭐⭐⭐ WeatherFan2024  GBR                   2024-12-13
Finally, a weather app that gets it right
Love the radar view and the hourly breakdown. The severe weather alerts 
have been spot on. Highly recommend!
────────────────────────────────────

⭐⭐⭐⭐☆ AppReviewer  CAN                   2024-12-12
Great app with room for improvement
The app is fantastic overall. My only complaint is that the Apple Watch 
complication sometimes doesn't update. Otherwise perfect!
────────────────────────────────────

⭐⭐⭐☆☆ CasualUser123  AUS                   2024-12-11
Good but expensive
The app works well but the subscription price is a bit high compared to 
other weather apps. Would love to see a one-time purchase option.

Showing 4 reviews
pomme reviews summary 
$ pomme reviews summary 123456789

📊 Generating review summary for app 123456789...

📊 Review Summary
════════════════════════════════════════════════════════════

Overall Statistics
────────────────────────────────────────
  Average Rating: 4.6 ⭐⭐⭐⭐⭐
  Total Reviews: 8,743

Rating Distribution
────────────────────────────────────────
  5⭐ ████████████████████████████   5,892 ( 67.4%)
  4⭐ ████████████                   1,834 ( 21.0%)
  3⭐ ████                             623 (  7.1%)
  2⭐ ██                               287 (  3.3%)
  1⭐ █                                107 (  1.2%)

Top Territories
────────────────────────────────────────
  Territory   Reviews  Avg Rating
  ──────────  ───────  ──────────
  USA         3,247    4.7
  GBR         1,423    4.6
  CAN           892    4.5
  AUS           734    4.6
  DEU           523    4.4
  FRA           412    4.5
  JPN           389    4.8
  ITA           234    4.3
  ESP           189    4.4
  NLD           156    4.7

Recent Reviews
────────────────────────────────────────

  ⭐⭐⭐⭐⭐ TechEnthusiast  2024-12-14
  Best weather app I've ever used!

  ⭐⭐⭐⭐⭐ WeatherFan2024  2024-12-13
  Finally, a weather app that gets it right

  ⭐⭐⭐⭐ AppReviewer     2024-12-12
  Great app with room for improvement

Generated: 2024-12-15 09:25:03

Quick Installation

Get started in seconds

🐧

Arch Linux (AUR)

Recommended for Arch users

$ yay -S pomme
# or using paru: paru -S pomme
# for development version: yay -S pomme-git
🍺

macOS

via Homebrew

$ brew tap marcusziade/tap
$ brew install pomme
🐹

Go Install

via go install

$ go install github.com/marcusziade/pomme/cmd/pomme@latest
📦

Binary

Direct download

$ curl -L https://github.com/marcusziade/pomme/releases/latest/download/pomme_$(uname -s)_$(uname -m).tar.gz | tar xz
$ sudo mv pomme /usr/local/bin/
🔨

Source

Build yourself

$ git clone https://github.com/marcusziade/pomme.git
$ cd pomme && go build -o pomme ./cmd/pomme/main.go

Configuration

Create your configuration file at ~/.config/pomme/pomme.yaml

api:
base_url: https://api.appstoreconnect.apple.com/v1
timeout: 30
defaults:
output_format: table
vendor_number: YOUR_VENDOR_NUMBER
auth:
key_id: YOUR_KEY_ID
issuer_id: YOUR_ISSUER_ID
private_key_path: /path/to/your/AuthKey.p8

Ready to transform your App Store workflow?

Join developers who are already using Pomme to manage their apps efficiently.

View on GitHub Download Latest