The screen recording CLI
built for AI agents.

Open-source screen recording CLI that turns AI-driven browser sessions into polished, shareable videos. One command.

$ npx screencli init
GitHub → · How it works · Pricing
screencli
$ npx screencli record https://app.example.com \
    -p "Demo the new dashboard"

  Agent Actions
  [01] navigate app.example.com
  [02] click Sign in button
  [03] type user@example.com
  [04] click Dashboard tab
  [05] scroll down to metrics
  [06] done Dashboard walkthrough complete

  ✓ Video composed — recordings/a3f2c8e1/composed.mp4
  ✓ Uploaded — https://screencli.sh/v/a3f2c8e1

Works with every AI coding agent

Claude Code Cursor Windsurf Cline Aider OpenCode Antigravity Continue

Install the agent skill: npx skills add usefulagents/screencli --skill screencli

01

Record once.
Use everywhere.

Your AI agent creates polished recordings for demos, verification, and automation.

🎬

Product demos

Ship a feature, record a demo. The agent walks through your app and produces a shareable video with one command. No screen-sharing, no retakes.

-p "Walk through the new onboarding flow and show the completed dashboard"
✅

Visual verification

Let the AI verify its own work. After implementing a feature, the agent records a walkthrough to prove it works — visual proof, not just green tests.

-p "Verify the checkout flow works end-to-end with a test purchase"
⚙

CI/CD pipelines

Auto-generate a demo video on every pull request. The agent reads the diff, visits the preview deployment, and posts a recording as a PR comment.

-p "Show the changes introduced in this PR on the staging URL"
02

The AI drives.
You get the video.

A screen recording CLI with natural language prompts, studio-grade output, and no video editor.

prompt

Natural language control

Describe what to record in plain English. The AI agent navigates, clicks, types, and scrolls — no scripted sequences or selectors.

auto

Auto post-production

Idle time trimmed. Click positions highlighted. Smooth cursor trails rendered. Auto-zoom to the action. Zero manual editing.

--login

Auth handoff

You log in manually, press Enter, and the AI takes over your authenticated session. Login is never recorded. Sessions are saved for reuse.

--preset

Export everywhere

One command per platform. YouTube, Twitter, Instagram, TikTok, LinkedIn, and GitHub GIF presets built in.

03

Six backgrounds.
Choose your vibe.

Gradient backgrounds with rounded corners and drop shadows. Screen Studio quality, from your terminal.

app.example.com/dashboard
04

One command.
Shareable link.

01

Install

Sign in or paste your API key. Optionally install the skill for your coding agent.

$ npx screencli init
02

Record

Tell the agent what to demo. It drives the browser, you get a polished video.

$ screencli record https://your-app.com \
    -p "Walk through onboarding"
03

Auto-upload

The recording is composed with effects and uploaded automatically. You get a link.

✓ Uploaded
https://screencli.sh/v/a3f2c8e1
04

Export

Need a specific format? Export for any platform with one command.

$ npx screencli export ./recordings/a3f2c8e1 \
    --preset twitter
05

Simple pricing.

Start free. Upgrade when you need more.

Free
$0
15 credits / month
  • ✓ All effects & gradients
  • ✓ All export presets
  • ✓ Auto-upload & shareable links
  • ✓ Auth handoff
  • — Unlisted recordings
Get started
Pro
Pro
$12
100 credits / month
  • ✓ Everything in Free
  • ✓ Unlisted recordings
  • ✓ Cloud re-rendering
  • ✓ Priority support
  • ✓ Additional credits at $0.10 each
Start Pro

1 credit = 10 agent steps. No credit card required for Free.

06

Quick reference.

Everything you need, at a glance.

Record

npx screencli record <url> -p "prompt"

# With gradient background
npx screencli record https://app.com \
  -p "Demo the dashboard" \
  --background aurora

# With authentication
npx screencli record https://app.com \
  -p "Demo features" \
  --login --auth myapp

Export presets

npx screencli export <dir> --preset <name>

# Available presets
youtube    1920x1080  16:9  mp4
twitter    1280x720   16:9  mp4
instagram  1080x1920  9:16  mp4
tiktok     1080x1920  9:16  mp4
linkedin   1080x1080  1:1   mp4
github-gif  800x450   16:9  gif

Cloud commands

npx screencli login
npx screencli logout
npx screencli whoami
npx screencli recordings
npx screencli upload <dir>
npx screencli delete <id>
npx screencli render <id> --background sunset

Backgrounds & effects

--background <name>
  aurora  sunset  ocean
  lavender  mint  ember

--padding <%>        default 8
--corner-radius <px> default 12
--no-shadow  --no-zoom
--no-highlight  --no-cursor
06

Frequently asked

screencli is an open-source screen recording CLI built for AI agents. You give it a URL and a prompt — its built-in AI agent navigates the page, and screencli records the session with auto-trim, gradient backgrounds, click highlights, and auto-zoom. One command produces a ready-to-share MP4 with a hosted link.
No install needed — just run npx screencli record <url> -p "your prompt". On first run, the CLI opens a browser for GitHub login, then you're ready to record. For permanent installation, run npm install -g screencli.
Run: npx screencli record https://your-app.com -p "Walk through the main features". The AI agent opens the URL, follows your prompt instructions, and records everything. When it finishes, you get a composed video and a shareable link at screencli.sh. No setup, accounts, or API keys needed for the first run.
Yes. Use the --login flag to log in manually first, then the AI agent takes over your authenticated session. Add --auth myapp to save the session for future recordings: npx screencli record https://app.example.com -p "Show the dashboard" --login --auth myapp. Next time, just pass --auth myapp to reuse the saved session.
Record first, then export with the github-gif preset: npx screencli export ./recordings/your-recording --preset github-gif. This produces an optimized 800x450 GIF (max 12 seconds, under 8 MB) ready to embed in Markdown. Other presets: youtube, twitter, instagram, tiktok, and linkedin.
Any AI coding agent that can run shell commands can use screencli — it's a standard CLI tool. For Claude Code specifically, install the skill with npx skills add usefulagents/screencli --skill screencli, and Claude can record demos autonomously as part of your development workflow.
The CLI is fully free and open source (MIT license) — all video effects, gradient backgrounds, and export presets are included with no limits. The free cloud tier includes 10 recordings per month with shareable links. The Pro plan ($12/month) adds 100 recordings, full analytics, and removes the watermark.
Every recording automatically gets: idle time trimming (removes pauses between actions), auto-zoom (follows the active area), click highlights (visual pulse on clicks), and cursor trails. You also choose from 6 gradient backgrounds (aurora, sunset, ocean, lavender, mint, ember) with customizable padding, corner radius, and drop shadow.
Yes. By default, every recording auto-uploads to screencli.sh and you get a shareable link like screencli.sh/v/a3f2c8e1. The link shows an embedded video player with chapter markers, metadata, and a download button. Use --local to skip the upload and keep recordings local only.