# @percy/cli-app

> Percy CLI commands for running Percy with native apps.

Latest version **1.32.11** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @percy/cli-app
pnpm add @percy/cli-app
yarn add @percy/cli-app
bun add @percy/cli-app
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.32.11 |
| Published | 2026-09-24 |
| First published | 2022-08-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 86 |
| Maintainers | percy-admin |

## Links

- npm: https://www.npmjs.com/package/@percy/cli-app
- Repository: https://github.com/percy/cli
- Homepage: https://github.com/percy/cli#readme
- Issues: https://github.com/percy/cli/issues
- npm.io page: https://npm.io/package/@percy/cli-app

## Recent versions

- 1.32.11 (latest) — 2026-09-24
- 1.32.12-beta.4 (beta) — 2026-10-21
- 1.31.15-alpha.0 (alpha) — 2026-05-21
- 1.32.12-beta.3 — 2026-10-16
- 1.32.12-beta.2 — 2026-10-09
- 1.32.12-beta.1 — 2026-10-06
- 1.32.12-beta.0 — 2026-10-01
- 1.32.11-beta.2 — 2026-09-22
- 1.32.11-beta.1 — 2026-09-22
- 1.32.11-beta.0 — 2026-09-21
- 1.32.10 — 2026-09-17
- 1.32.10-beta.1 — 2026-09-11
- 1.32.10-beta.0 — 2026-09-08
- 1.32.9 — 2026-09-08
- 1.32.9-beta.1 — 2026-09-08
- … 282 more at https://npm.io/package/@percy/cli-app/versions

## README

# @percy/cli-app

Percy CLI commands for running Percy with native apps.

## Commands
<!-- commands -->
* [`percy app:exec`](#percy-appexec)

### `percy app:exec`

Start and stop Percy around a supplied command for native apps

```
Usage:
  $ percy app:exec [options] -- <command>

Subcommands:
  app:exec:start [options]  Starts a locally running Percy process for native apps
  app:exec:stop [options]   Stops a locally running Percy process
  app:exec:ping [options]   Pings a locally running Percy process
  help [command]            Display command help

Options:
  --parallel                Marks the build as one of many parallel builds
  --partial                 Marks the build as a partial build

Percy options:
  -c, --config <file>       Config file path
  -d, --dry-run             Print snapshot names only
  -P, --port [number]       Local CLI server port (default: 5338)

Global options:
  -v, --verbose             Log everything
  -q, --quiet               Log errors only
  -s, --silent              Log nothing
  -l, --labels <string>     Associates labels to the build (ex: --labels=dev,prod )
  -h, --help                Display command help
```
<!-- commandsstop -->

---
_Source: https://npm.io/package/@percy/cli-app · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._