Skip to content
Running a workshop

Stream your saves, not your screen.

One command turns a folder into a live, read-only link. Viewers follow every save in their browser, no account needed.

Psst, start here
curl -fsSL https://raw.githubusercontent.com/biga-sh/cli/main/install.sh | sh
Watch it run
Your editor⌘S

src/client.ts

- const retries = 3;+ const retries = 5;

$ biga start

checkpoint#41

localhost:3000

SSE
Laptop#41
Projector#41
Phone#41
  • Workshops
  • Pair programming
  • Code review
  • Livestreams
  • Teaching
  • Mentoring
  • Demo days
  • Onboarding
  • Interviews

A screen share sends pixels. biga sends the files themselves, so viewers can select, search and scroll at their own pace.

01 / How it works

Run it, share it, keep coding.

A whole session, start to rejoin, in under a minute. Reach in and it steps aside so you can drive.

~/code/biga
You
config.go
zsh
not broadcasting
Priya

Waiting for a link

Priya pastes your share link here. No sign-in, nothing to install.

02 / Checkpoints

Every save becomes a checkpoint.

biga hashes each file it reads. A burst of saves goes out as one checkpoint, and a save that changes nothing sends nothing.

SHA-256per file

Bytes that match the last upload never leave your machine.

120 msof quiet

A burst of saves waits until the folder settles, then goes as one.

1 sat most

A long burst still flushes every second, so nobody waits on you.

Allkept

Every checkpoint stays in the session for viewers to step back through.

mssave
03 / Privacy

Your .env stays on your machine.

This is the viewer your link opens, pulled apart. Every panel is built only from files that passed your ignore rules, and only the ones that changed travel.

localhost:3000/session/k3f9zq2a
04 / Details

Small tool, sharp edges filed off.

The parts you notice after a week of using it.

biga.json

One command, every project.

List folders in a biga.json, or pass several on the command line. Each gets its own session and its own link.

biga.json
backend/API
/session/k3f9zq2a
frontend/
/session/p7d2mx4c
rejoin

Same link after a crash.

Run biga start again in the same folder. It rejoins the session and uploads only what changed.

history

Step back through every save.

Viewers scrub the checkpoint timeline and open the diff for any file.

viewer

Built for reading.

Quick open with ⌘P, syntax highlighting, and Follow, which opens each file as it's saved.

self-host

Run it yourself.

One Next.js app on Postgres. Redis is optional, for fan-out across instances. MIT licensed.

DATABASE_URL=postgres://…
REDIS_URL=     # optional
Self-hosting guide
05 / Try it

Open a real broadcast.

This is the actual viewer, playing back a finished session of this repository. The tree, the timeline and the diffs all work.

localhost:3000/session/heczlzfaOpen

Already have a link?

Paste it here, or just open it. Viewers never need an account.

Viewers are read-only. Nothing is installed, and no account is created.

Share your next save.

Run a workshop, pair across timezones, or let people watch you build. Two commands, then send the link.

MIT licensed. Issues and PRs welcome
  1. 1 Install
    curl -fsSL https://raw.githubusercontent.com/biga-sh/cli/main/install.sh | sh
  2. 2 Start in your project
    biga start