A screen recorder
for your AI agent.

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

screencli
$ npx screencli record https://app.example.com \
    -p "Demo the new dashboard"

  screencli record
  ℹ Recording ID: a3f2c8e1
  ℹ URL: app.example.com
  ℹ Viewport: 1920x1080
  ✓ Browser launched

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

  ✓ Video composed — recordings/a3f2c8e1/composed.mp4

Built for the AI agent ecosystem

Claude Code Cursor Windsurf Cline Aider OpenCode Antigravity Continue
01

Everything your agent
demo needs.

Record, polish, and export. No video editor required.

--login

Human handoff

You log in manually. Press Enter. The AI agent picks up your authenticated session. Login is never recorded.

auto

Auto post-production

Idle time trimmed. Click positions highlighted. Smooth cursor trails rendered. Zero manual editing.

--background

Studio-grade backgrounds

Six gradient presets. Rounded corners. Drop shadows. Screen Studio quality straight from your terminal.

--preset

Export everywhere

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

02

Six backgrounds.
Choose your vibe.

Colourful gradient backgrounds with rounded corners and drop shadows. Like Screen Studio, but from your terminal.

app.example.com/dashboard
03

Up and running
in 60 seconds.

01

Login

$ npx screencli login
02

Record

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

Export

$ npx screencli export ./recordings/<id> \
    --preset twitter --background sunset
04

Share

$ npx screencli push ./recordings/<id>
  https://screencli.sh/v/a3f2c8e1
04

Free and
open source.

MIT licensed. No paywalls. No feature gates. Everything included.

$0
MIT License — free forever
  • All 6 gradient backgrounds
  • All export presets — 6 platforms
  • Human handoff authentication
  • Auto-trim, zoom, highlights, cursor
  • Unlimited recordings
  • Claude skill included
View on GitHub
05

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 --no-headless

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

Export

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

Backgrounds

--background <name>

  aurora    purple / blue / green
  sunset    orange / pink / magenta
  ocean     deep blue / teal / cyan
  lavender  purple / pink / soft blue
  mint      green / teal / aqua
  ember     red / orange / amber

--padding <%>        default 8
--corner-radius <px> default 12
--no-shadow

Auth flow

# First run: login + save
npx screencli record https://app.com \
  -p "demo" --login --auth myapp

# Next runs: reuse saved auth
npx screencli record https://app.com \
  -p "demo" --auth myapp

# Saved to ~/.screencli/auth/