llms.txt

# @appolabs/appo

> The Appo CLI: turn a website into native iOS and Android apps and publish them on the App Store and Google Play, from the terminal or an agent.

A thin, dependency-free Node client over the Appo public API (`/api/v1`) and the
RFC 8628 device-authorization grant. Run the complete Appo app lifecycle —
create, ship, publish, push — from a shell or an agent. Two canonical commands:
`appo new` (the app on your phone) and `appo ship` (the app on the stores).
An AI agent can run the CLI or use the remote MCP connector,
`https://apps.goappo.io/mcp`, which `appo mcp` registers.

## Preparation choice (agents)

`appo new` and `appo apps create` need `--prepare off` (the user or their developer
maintains the website's code) or `--prepare on --owner-authorized --accept-tos`
(Appo's team adapts the site; the user confirms ownership and accepts the Terms of
Service, https://goappo.io/en/terms). Under `--json` or without a terminal, when the
flags are missing, the command creates nothing, issues no request, prints an
`input_required` envelope with code `preparation_choice_required` or
`attestation_required` and exits 2. An agent must ask the user these questions, as
separate steps, and must not choose the flags itself; then re-run with the flags the
envelope names. See [appo new](README.md#appo-new).

## Quick Start

- [Install](README.md#install)
- [appo init](README.md#appo-init)
- [appo new](README.md#appo-new)
- [appo ship](README.md#ship)

## Commands

- [appo new](README.md#appo-new)
- [appo ship](README.md#ship)
- [appo init](README.md#appo-init)
- [appo login / logout / whoami](README.md#auth)
- [appo env list / env use](README.md#environments)
- [appo apps create / apps list / apps show / apps check / apps update](README.md#apps)
- [appo status](README.md#status): app overview; the try line is the readiness answer
- [appo run](README.md#run): prints the one preview link and QR code, or what Appo is still doing; starts no build
- [appo rejection](README.md#rejection)
- [appo fix-recipe](README.md#fix-recipe)
- [appo publish](README.md#publish)
- [appo push](README.md#push)
- [appo download](README.md#download)
- [appo devices list / devices register](README.md#devices)
- [appo mcp](README.md#mcp)
- [appo upgrade / --version](README.md#upgrade)

## Reference

- [Environment variables](README.md#environment-variables)
- [Exit codes](README.md#exit-codes)
- [Non-interactive / CI auth](README.md#ci-auth)
- [Releasing](README.md#releasing)