# Terminal Session Run — effect skill for code & terminal

> **For AI agents:** find the right skill in one call — `curl -s "https://varg.ai/how-to/api/search?q=<what the person wants>"` returns the matching how-to page and the best skills with install commands, as markdown (Russian works too). Full index: https://varg.ai/how-to/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the how-to page.

A terminal types a command, then streams real-looking log output with green checks.

- **Type:** [Effect](https://varg.ai/how-to/effects.md) · [Code & terminal](https://varg.ai/how-to/browse/skills/code.md)
- **Slug:** `terminal-session-run`
- **Status:** live
- **Publisher:** HeyGen (community)
- **License:** Apache-2.0
- **Source:** https://github.com/heygen-com/hyperframes/tree/main/registry/components/terminal-simulator
- **Works in:** Claude Code, Claude.ai, Codex, Cursor, OpenClaw, Gemini CLI, Any MCP client, varg Studio
- **Requires:** ffmpeg, HyperFrames (npx hyperframes), Remotion, CapCut (by hand)
- **Cost:** Free — the take renders locally; generated footage, if any, bills by the model

## What it does

Built on [Terminal Simulator](https://github.com/heygen-com/hyperframes/tree/main/registry/components/terminal-simulator) by HeyGen (HyperFrames), Apache-2.0. The write-up and recipes below are varg's.

Dark terminal with traffic lights, prompt types at human speed, output lines roll in faster, old lines scroll off the top.

**When:** CLIs, deploy tools, agents that run in the terminal.

**Watch out:** Do not stream walls of logs; keep 4–8 meaningful lines and fake-skip the rest with "…".

**Timing:** Typing 50–100 ms/char; output lines every 80–200 ms; 0.5 s pause before the final success line.

**Also called:** CLI demo, terminal window, command run

### In FFmpeg

```bash
# record a reproducible session with VHS (uses ffmpeg under the hood)
# demo.tape: Set TypingSpeed 75ms\nType "npx varg render"\nEnter\nSleep 3s
vhs demo.tape
```

### In HyperFrames

```bash
npx hyperframes add terminal-simulator
```
Or `code-terminal-run` for one command with a token-chrome panel.

### In Remotion

```tsx
// npx shadcn@latest add @remocn/terminal-simulator
<TerminalSimulator commands={[{cmd:'npx varg render', output:['✓ scenes 4','✓ audio','✓ done in 38s']}]}/>
```

### In CapCut

Record the real terminal (or a VHS tape), trim the waits, speed up output 2×, zoom on the final line.

### Ready-made components

- [Terminal Simulator](https://skills.varg.ai/component/hf.terminal-simulator/) (hyperframes): npx hyperframes add terminal-simulator
- [Code Terminal Run](https://skills.varg.ai/component/hf.code-terminal-run/) (hyperframes): npx hyperframes add code-terminal-run
- [Terminal Simulator](https://skills.varg.ai/component/remocn.terminal-simulator/) (remocn): npx shadcn@latest add @remocn/terminal-simulator

### Where this comes from

- [charmbracelet/vhs: terminal recordings as code (TypingSpeed, Sleep)](https://github.com/charmbracelet/vhs)

## Use when

- CLIs, deploy tools, agents that run in the terminal.

## Not for

- Do not stream walls of logs; keep 4–8 meaningful lines and fake-skip the rest with "…".

## Install

- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg`
- Codex: `npx skills add vargHQ/skills --skill varg-video-edit-library -a codex -y`
- Cursor: `npx skills add vargHQ/skills --skill varg-video-edit-library -a cursor -y`

## Example output

https://s3.varg.ai/how-to/previews/7b3d64d5d345/take-terminal-session-run.mp4 — The Terminal Simulator component used as its header comment describes, with demo copy (credit: Rendered by varg · HyperFrames Terminal Simulator, https://hyperframes.heygen.com/catalog/components/terminal-simulator)

## More code & terminal skills

- [Editor Types the Code](https://varg.ai/how-to/skills/editor-types-the-code.md): Syntax-highlighted code types into an editor window with a caret riding the frontier.
- [Red/Green Diff Collapse](https://varg.ai/how-to/skills/red-green-diff.md): Removed lines flash red and collapse away while added lines expand in green.
- [Spotlight One Line of Code](https://varg.ai/how-to/skills/spotlight-one-line.md): A highlight band sweeps onto the one line that matters while the rest of the file dims.
- [Code Morphs Between Versions](https://varg.ai/how-to/skills/code-morphs-versions.md): One snippet transforms into the next: shared tokens glide to new positions, removed ones fade, new ones fade in.
- [One-Line Install Card](https://varg.ai/how-to/skills/one-line-install-card.md): A single install command types into a small terminal card, prints a success check, and holds.
- [Camera Scrolls a Long File](https://varg.ai/how-to/skills/camera-scrolls-long-file.md): The view scrolls through a long file and stops with the target line centered and lit.

## Run the generation on varg

varg is one API key for the models these skills drive — Seedance 2.5, Kling 4, Veo 3.1, Wan 3, Nano Banana 2.1, GPT Image 2.5, ElevenLabs v4 and 200+ more — billed in credits, with a cost estimate before anything runs.

- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg` (skill + hosted MCP)
- Codex, Cursor, Gemini CLI, OpenClaw: `npx skills add vargHQ/skills --skill varg-ai -a <agent> -y`
- Grok and any agent that reads SKILL.md: `npx skills add vargHQ/skills --skill varg-ai`, or point it at the skill's SKILL.md
- Claude.ai, ChatGPT, any MCP client: connect `https://mcp.varg.ai/mcp`
- API key: https://varg.ai/dashboard/api · Model specs: https://varg.ai/models/llms.txt