> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asccli.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

# Introduction

> A fast, lightweight, and scriptable CLI for the App Store Connect API

Welcome to the **App Store Connect CLI** (`asc`) - an unofficial, community-driven command-line tool for automating iOS, macOS, tvOS, and visionOS release workflows.

## What is asc?

`asc` is a Go-based CLI that provides direct access to the App Store Connect API from your terminal, IDE, or CI/CD pipeline. It's designed to be:

* **Fast**: Built in Go with minimal dependencies
* **Lightweight**: Single binary with no runtime requirements
* **Scriptable**: JSON output, exit codes, and TTY-aware defaults
* **Agent-friendly**: Built by AI agents, for AI agents

<Note>
  This project is an independent, unofficial tool and is not affiliated with, endorsed by, or sponsored by Apple Inc.
</Note>

## Key features

<CardGroup cols={2}>
  <Card title="TestFlight automation" icon="plane">
    Upload builds, manage beta testers, collect feedback, and analyze crashes
  </Card>

  <Card title="App Store releases" icon="store">
    Submit versions, manage metadata, handle screenshots, and track reviews
  </Card>

  <Card title="Signing & certificates" icon="certificate">
    Manage certificates, provisioning profiles, and bundle IDs
  </Card>

  <Card title="CI/CD integration" icon="robot">
    GitHub Actions, GitLab CI, Bitrise, CircleCI support with structured output
  </Card>
</CardGroup>

## Why use asc?

### For developers

* Skip the App Store Connect web interface for repetitive tasks
* Automate build distribution to TestFlight
* Script metadata updates across multiple localizations
* Monitor crash reports and feedback from the command line

### For teams

* Integrate App Store Connect into your existing CI/CD workflows
* Version-control your release processes
* Standardize deployment procedures across projects
* Audit and track all API operations

### For AI agents

* Self-documenting commands via `--help`
* Structured JSON output for parsing
* Deterministic behavior with explicit flags
* No interactive prompts (use `--confirm` flags)

## Common workflows

Here are some everyday tasks you can automate with `asc`:

<AccordionGroup>
  <Accordion title="Distribute builds to TestFlight">
    ```bash theme={null} theme={null}
    asc builds upload --app "123456789" --ipa "/path/to/MyApp.ipa"
    asc builds list --app "123456789" --output table
    ```
  </Accordion>

  <Accordion title="Monitor feedback and crashes">
    ```bash theme={null} theme={null}
    asc testflight feedback list --app "123456789" --paginate
    asc testflight crashes list --app "123456789" --sort -createdDate --limit 10
    ```
  </Accordion>

  <Accordion title="Submit for App Store review">
    ```bash theme={null} theme={null}
    asc release stage --app "123456789" --version "1.2.3" --build "BUILD_ID" --copy-metadata-from "1.2.2" --dry-run
    asc publish appstore --app "123456789" --ipa "./MyApp.ipa" --version "1.2.3" --submit --confirm
    ```
  </Accordion>

  <Accordion title="Manage signing certificates">
    ```bash theme={null} theme={null}
    asc certificates list
    asc profiles list
    asc bundle-ids list
    ```
  </Accordion>
</AccordionGroup>

## TTY-aware output

`asc` automatically chooses sensible defaults based on where stdout is connected:

* **Interactive terminal (TTY)**: `table` format for human readability
* **Pipes, files, CI**: `json` format for machine parsing

You can override this behavior:

```bash theme={null} theme={null}
# Set a global preference
export ASC_DEFAULT_OUTPUT=markdown

# Or use explicit flags (always wins)
asc apps list --output json
asc builds list --output table
```

## Wall of Apps

**60+ apps ship with asc**, including:

* Developer tools and utilities
* Productivity apps
* Entertainment and games
* Health and fitness trackers

[View the complete Wall of Apps →](https://asccli.sh/#wall-of-apps)

Want to add your app? See our [contributing guide](/resources/contributing).

## Next steps

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/installation">
    Install asc via Homebrew or install script
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Set up your App Store Connect API credentials
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Run your first commands and explore workflows
  </Card>

  <Card title="Commands" icon="terminal" href="/commands/overview">
    Browse the complete command reference
  </Card>
</CardGroup>