# Skicy

> Skicy is a native macOS app (macOS 14 or later) by Code Works OOD that turns raw app captures into finished store screenshots for the Apple App Store, Google Play, the Mac App Store, and the Microsoft Store. It frames captures in real device bezels (iPhone, iPad, Apple Watch, Mac, Google Pixel), lays up to ten screens on one continuous background, exports pixel exact PNGs for every store preset, uploads directly to App Store Connect, and ships a headless `agent` CLI that AI coding agents can drive. One time purchase, no account, all rendering happens locally.

Key facts:

- Platform: macOS 14 or later, Apple silicon native. Coming soon to the Mac App Store; a Developer ID (DMG) build exists for automation. The Mac App Store build runs sandboxed and cannot read arbitrary CLI paths, so use the Developer ID build for headless work.
- Binary: /Applications/Skicy.app/Contents/MacOS/Skicy (commonly aliased as `skicy`).
- Project format: `.skicy`, an open directory format of JSON plus embedded image copies. Agents can author it with only the binary. Legacy `.vitrine` packages open through the same CLI.
- CLI verbs: docs, list, new, describe, set-project, add-image, preview, export, validate, asc-apps, asc-upload. Every verb prints JSON to stdout and exits non-zero on failure.
- Recommended agent loop: new, then add-image, then describe or set-project to edit the JSON, then preview (render a PNG, read it back, critique, iterate), then export or asc-upload.
- App Store Connect auth for asc-* verbs: --issuer-id / --key-id / --key flags, or the SKICY_ASC_ISSUER_ID, SKICY_ASC_KEY_ID, SKICY_ASC_KEY_PATH environment variables.
- The canonical, complete CLI manual ships inside the app. Run `skicy agent docs` to print it, or `skicy agent docs --path` for its location in the bundle. Prefer that manual over this summary when they disagree.

## CLI quick reference

```
skicy agent new --out release.skicy --template bold-punch [--preset iphone-69] [--screens N]  # create a project (N: 1-10)
skicy agent describe --project release.skicy                                                  # print the project JSON to stdout
skicy agent set-project --project release.skicy --json edits.json                             # replace the project JSON ("--json -" reads stdin)
skicy agent add-image --project release.skicy --file shot.png --screen 1 --as screenshot      # attach a capture (local path or https URL; --as layer|background also valid)
skicy agent preview --project release.skicy --out preview.png --max-width 1500                # render the whole strip to one PNG for review
skicy agent export --project release.skicy --out ./out --base release                        # export store sized PNGs
skicy agent validate --project release.skicy                                                  # lint the project
skicy agent list presets|templates|themes|frames                                              # enumerate valid ids
skicy agent asc-apps                                                                          # list App Store Connect apps
skicy agent asc-upload --project release.skicy --bundle-id com.you.app --locale en-US [--replace] [--dry-run]
skicy agent docs [--path]                                                                     # print the full bundled manual
```

## Docs

- [Support and FAQ](https://skicy.codeworks.bg/support.html): common questions, App Store Connect upload help, and agent CLI pointers
- [Agent CLI notes](https://skicy.codeworks.bg/support.html#agent-cli): where the CLI manual lives and how to read it
- [Privacy policy](https://skicy.codeworks.bg/privacy.html): what Skicy does and does not collect

## Optional

- [Landing page](https://skicy.codeworks.bg/): feature overview, template gallery, and the machine readable CLI quick reference