Demo CLI

The ClipStitchr CLI records your local product in a clean browser window, uploads the take, and saves it as a Demo clip. It is built for app founders who need fresh product footage without exporting files from a screen recorder.

Use it when you changed the product, need a cleaner walkthrough, or want ClipStitchr to turn a wide web demo into a vertical-ready clip with a background instead of cutting off the screen.

Install the command once from npm. After that, run clipstitchr from any product repo you want to connect.

Use these when you want to check what is installed or see the latest command options from your terminal. Add --plain when you want uncolored output for logs or screenshots.

Login connects this machine to your ClipStitchr account. The CLI shows a short code, opens ClipStitchr in your browser, and waits while you sign in. In the browser, make sure the code matches the one in Terminal, then connect the machine. Logout removes the saved machine session.

Run the command from the folder where your app lives. The CLI opens a short setup, connects your ClipStitchr account, finds common app folders like web, and saves the local run settings in the repo.

Status shows the account, repo, product, local app, and recording browser in one quick view. Scan looks for likely product flows in the local app. Doctor checks the pieces the recorder needs, including native recording tools when the repo looks like iOS, Android, or React Native. Update checks npm for a newer CLI.

Unlink removes this repo connection without logging the whole machine out of ClipStitchr. It can also remove this repo's saved recording browser session and local recordings if you choose that during the prompt.

List products when you need the IDs for scripting. Create adds a new product to your ClipStitchr account. Use saves the product this repo should record against.

Choose Make a product demo. The CLI starts your local app, opens the recording browser, and tells you when to walk through the product. When the take is done, return to the terminal and press Enter.

If the app asks you to sign in, log in inside the recording browser. The CLI keeps that browser session for the same repo, so the next recording is faster.

Most demos work best around 30-90 seconds, but longer recordings are allowed. If your app needs time for loading, AI generation, or processing, keep recording and ClipStitchr can cut waiting time later.

Already have a recording? Upload the file directly and ClipStitchr will process it like any other Demo clip.

Most users do not need this. Use --api when testing against a local or preview ClipStitchr web app.

Web app demos are recorded at a full desktop size, then prepared for vertical ads with a fit-with-background layout. ClipStitchr can also use your clicks to add smooth zooms around the parts of the product you touched.

The CLI warns when a recording gets long, but it does not stop web or iOS recordings for you. Android recording may stop around 3 minutes because of the device recorder.

iOS, Android, and React Native demos record from an already-open simulator, emulator, or device. Open the app where you want to start, then let the CLI start and stop the recording.

The CLI saves repo settings in .clipstitchr.yml and local recording files in .clipstitchr. Keep .clipstitchr ignored by Git so recordings and browser login state stay off your repo.