# @screeny-sh/record

The `screeny` command and the TypeScript recording API for [Screeny](https://screeny.sh) — polished screen recordings of real macOS apps, driven by ordinary trusted TypeScript.

```bash
npm install -g @screeny-sh/record   # the screeny command
npm install @screeny-sh/record      # in your project, for the module import
```

Recording modules import this package:

```ts
import { capture, defineRecording, target } from "@screeny-sh/record";
```

Recording and rendering require [Screeny.app](https://screeny.sh) — the CLI is an unprivileged controller that launches and drives the app. Install the app, grant its permissions with `screeny permissions --request`, then:

```bash
screeny record demo.screeny.ts --out session/take-01/
```

Full workflow — takes, moments, cuts, rendering — is documented in the agent skill the app installs, and at [screeny.sh](https://screeny.sh).