Installation

Install Repterm

Add Repterm as a dev dependency using your preferred package manager:

# Bun (recommended)
bun add -d repterm

# npm
npm install --save-dev repterm

# pnpm
pnpm add -D repterm

Repterm's recording mode captures terminal sessions using asciinema and tmux. These are only required if you plan to use --record mode.

brew install asciinema tmux

sudo apt-get install asciinema tmux

Use your distribution's package manager to install asciinema and tmux. Both are widely available in standard repositories.

If you prefer a standalone binary without adding Repterm to your project dependencies:

curl -fsSL https://cdn.tensor-fusion.ai/archive/repterm/install.sh | bash

You can customize the install location and version:

REPTERM_VERSION=0.1.1 REPTERM_INSTALL_DIR=~/.local/bin \
  curl -fsSL https://cdn.tensor-fusion.ai/archive/repterm/install.sh | bash

This installs the repterm CLI globally and is useful for CI environments or quick evaluation.

After installing, confirm everything is working:

# Check that Repterm is available
bunx repterm --help

# Check recording dependencies (optional)
asciinema --version
tmux -V

Once installed, head to Getting Started to write your first test.