Back to docs

Docs

ClipStitchr CLI

Record demos, start batch content, check your library, and queue finished Stitches from your terminal.

Updated 2026-07-06

What it does

The ClipStitchr CLI brings the parts of ClipStitchr that fit naturally in Terminal into the repo you already have open. You can record local product demos, upload existing demos, start batch content, list saved work, and add finished Stitches to the queue.

Use it when you changed the product, need a cleaner walkthrough, want to kick off a batch without opening the dashboard, or need a finished Stitch queued from a script.

Install and open it

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

npm install -g clipstitchr
clipstitchr

Help and version

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.

clipstitchr --help
clipstitchr help
clipstitchr help demo make
clipstitchr --version
clipstitchr --plain status

Connect your account

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.

clipstitchr login
clipstitchr logout

Connect a repo

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.

  • Choose Connect this repo to ClipStitchr.
  • Pick the product the demo belongs to.
  • Confirm the start command if the CLI found one.
  • Confirm the local URL to record.
clipstitchr link
clipstitchr init

Check and update setup

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.

clipstitchr status
clipstitchr scan
clipstitchr doctor
clipstitchr update

Change the linked repo

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.

clipstitchr unlink

Manage products

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.

clipstitchr products list
clipstitchr products create
clipstitchr products create --use
clipstitchr products use
clipstitchr products use product_123

Create batch drafts

You can start batch content from Terminal after your clips, demos, products, and batch settings are ready in ClipStitchr. Stitchr uses recent Hook/UGC clips and Demo clips. Swipr uses your saved dashboard batch settings.

  • Stitchr creates finished Stitch tasks in the background.
  • Swipr queues editable Swipe drafts in the background.
  • Open the dashboard to review, edit, and approve the finished drafts.
clipstitchr stitchr batch
clipstitchr stitchr batch --product product_123
clipstitchr stitchr batch --template template_123 --product product_123
clipstitchr swipr batch
clipstitchr swipr batch --product product_123

Find and queue content

Library commands show the IDs you need for scripts. Queue adds a finished Stitch to your Post Bridge queue, using the connected accounts saved on the product unless you pass account IDs yourself.

  • Queue does not ask for a date or time.
  • The Stitch needs a finished rendered video before it can be queued.
  • Swipe queueing still happens in the dashboard because Swipes are rendered in the browser before posting.
clipstitchr library clips --kind demo
clipstitchr library stitches --ready
clipstitchr library swipes
clipstitchr queue stitch
clipstitchr queue stitch stitch_123 --caption "New demo is live"
clipstitchr queue stitch stitch_123 --accounts 123,456

Record a demo

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.

  • Use --no-upload when you only want the local MP4.
  • Use --output when you want to choose where the MP4 is saved.
  • Use --product, --start, or --url when you want to skip prompts.
clipstitchr demo make
clipstitchr demo make --no-upload
clipstitchr demo make --output ./demo.mp4
clipstitchr demo make --product product_123 --url http://localhost:3000
clipstitchr demo make --start "cd web && npm run dev"

Upload an existing demo

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

  • Use --no-wait when you want to leave processing running in ClipStitchr.
  • Use --product when you already know the product ID.
clipstitchr demo upload ./demo.mp4
clipstitchr demo upload ./demo.mp4 --no-wait
clipstitchr demo upload ./demo.mp4 --product product_123

Use another ClipStitchr app URL

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

clipstitchr --api http://localhost:3000 login
clipstitchr --api https://your-preview-url.example.com link
clipstitchr --api https://your-preview-url.example.com products list

What to expect

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.

Where the files go

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.