Skip to content

docs: re-record the demo with the approval in lox run - #255

Merged
DavidGodefroid merged 3 commits into
mainfrom
docs/253-demo-lox-run
Nov 18, 2026
Merged

DavidGodefroid merged 3 commits into
mainfrom
docs/253-demo-lox-run

Conversation

@DavidGodefroid

@DavidGodefroid DavidGodefroid commented Nov 18, 2026 •

Copy link
Copy Markdown
Owner

Closes #253

What changed

  • New demo: docs/assets/demo.gif (README), site/assets/demo.mp4, demo.webm, demo-poster.jpg (locksql.com). Same scenario as before (top 3 Belgian customers, name and email), but the ticket is now answered in lox run, and the masked cells are <redacted>.
  • README: the caption "Recorded before approvals moved to lockhub…" is gone; the alt text lists the five steps.
  • Site: caption and fallback alt text of the demo describe the new recording. The video keeps its 1700x940 size, so the kit's CSS is untouched.
  • Topic security added to the repository (ai-agents, harness-security, mcp, security).
  • scripts/demo/: the three small scripts the recording was made with, so the next re-record is one command.

poster

How the demo was made: a real recording, not a scripted render

A real run on a throwaway PostgreSQL 17 in Docker (600 customers, 4,000 orders, generated), with the current releases:

Piece Version
locksql (lock image and the agent's client) v0.20.0, image by the digest lox add verified with cosign
lockhub / lox v0.12.1 (lox run --manual)
Agent Claude Code v2.1.327, Sonnet 5.5, started in the project as the quick start says

The agent's client ran through the v0.20.0 launcher (in the release image), so the console served it as a confined agent; no unconfined = true.

The screen was not filmed: scripts/demo/rec.py saved both tmux panes (text, colours, timing) each time one changed, and scripts/demo/render.py drew those screens (DejaVu Sans Mono, the site's terminal colours). Every character on screen comes from that run, in real time, with three disclosed exceptions:

  • the two pane titles in the top strip ("the agent · Claude Code", "you · lox run, in a terminal of its own") are added by the renderer;
  • four things of the recording machine are blanked: Claude Code's "Your login expires in 3 days" account notice, its "tmux focus-events off" tip, the plan name after the model in its header, and the "← N agents" count in its footer;
  • the feed of lox run also shows the lock's three start prompts and one earlier ticket of a trial run (they are real).

lox run is in manual mode so that the read is asked: with the default auto mode a read passes on the rules and no question appears. The caption and the alt text say "manual mode".

Verified

  • ffprobe: mp4 and webm 1700x940, 55.6 s; gif 1400x752. Sizes: gif 0.4 MB (was 4.1), mp4 0.7 MB (was 3.4), webm 0.9 MB (was 3.9). In the mp4 the question card is on screen from 28.1 s to 38.6 s (details opened at 33.0 s), the <redacted> table from 51.5 s to the end.
  • Frames read back from the mp4 and the gif (question card, final table with <redacted>).
  • gh repo view --json repositoryTopics lists security.
  • No README or site test exists in this repository; grep finds no other mention of the old caption.

🤖 Generated with Claude Code

The README GIF and the site video showed approvals in the old locksql
console. New recording of a real run: Claude Code v2.1.327 asks through
locksql v0.20.0, the ticket is approved in lox run v0.12.1 (lockhub
v0.12.1, manual mode), and the agent gets name and email as <redacted>.

- docs/assets/demo.gif, site/assets/demo.{mp4,webm}, demo-poster.jpg
- README: the 'recorded before lockhub' caption is gone; the alt text
  lists each step
- site: caption and alt text of the demo
- scripts/demo: how the recording was made (tmux capture, render, ffmpeg)

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
DavidGodefroid added a commit that referenced this pull request Nov 18, 2026
Refs DavidGodefroid/lockfamily#72

## What changed
The six items of the kit's "Resync for the colour direction (#72)"
(lockfamily `site-kit/KIT.md` and `COLOUR.md` at `e8bf7b6`, PR
DavidGodefroid/lockfamily#76), nothing else:

| # | File | How |
|---|---|---|
| 1 | `site/assets/tokens.css` | copy of lockfamily `assets/tokens.css`
(`cmp`: identical) |
| 2 | `site/assets/lock-site.css` | copy of
`site-kit/assets/lock-site.css` (`cmp`: identical) |
| 3 | `site/assets/logo.svg` | copy of `assets/locksql.svg` (`cmp`:
identical) |
| 4 | the 6 pages (`index`, `install`, `how-it-works`, `security`,
`faq`, `404`) | `<html lang="en" data-accent="locksql">`; `theme-color`
`#fbf7ee` / `#1f1d26` |
| 5 | `site/assets/og.png`, `apple-touch-icon.png` | rendered from
`site-kit/tools/og.html` (headless Chrome, light scheme, 1200x630 and
180x180) |
| 6 | `docs/assets/banner-light.svg`, `banner-dark.svg` |
`site-kit/tools/banner_svg.py --name locksql --tagline "Your agent
writes the query. You hold the key."` (`--check` passes) |

The site has no CSS of its own, no inline style and no colour hex in its
pages, so nothing had to be adapted on top of the kit. The accent is the
kit's `locksql` set (violet `#6d35d8` light, `#ad8af0` dark), chosen
only by `data-accent`.

## Verified
- Headless Chrome over the DevTools protocol (`prefers-color-scheme`
emulated): home at 360, 768 and 1280 px in both schemes; the five other
pages at 360 and 1280 px in both schemes. No horizontal overflow on any
(`scrollWidth == clientWidth`).
- Looked at: home light and dark at 1280, home dark at 360, security
light at 1280, the social card and the touch icon.
- Contrast: the pages use only the kit's tokens; the kit's generator and
tests check AA for every pair it allows (lockfamily
`tests/test_site.py`).
- This repository has no site test (`tests/` does not exist); CI below.

Not in this PR: the demo video on the home page (old recording in these
screenshots) is replaced by #255. `docs/assets/logo.svg` is not one of
the six items and is unchanged.

## Home page, before / after

**1280 px, light**

| Before | After |
|---|---|
| <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/before-home-1280-light.png"
width="400"> | <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/after-home-1280-light.png"
width="400"> |

**1280 px, dark**

| Before | After |
|---|---|
| <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/before-home-1280-dark.png"
width="400"> | <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/after-home-1280-dark.png"
width="400"> |

**768 px, light**

| Before | After |
|---|---|
| <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/before-home-768-light.png"
width="400"> | <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/after-home-768-light.png"
width="400"> |

**768 px, dark**

| Before | After |
|---|---|
| <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/before-home-768-dark.png"
width="400"> | <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/after-home-768-dark.png"
width="400"> |

**360 px, light**

| Before | After |
|---|---|
| <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/before-home-360-light.png"
width="400"> | <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/after-home-360-light.png"
width="400"> |

**360 px, dark**

| Before | After |
|---|---|
| <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/before-home-360-dark.png"
width="400"> | <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/after-home-360-dark.png"
width="400"> |

Social card: <img
src="https://raw.githubusercontent.com/DavidGodefroid/locksql/pr-assets/256/og.png"
width="500">

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Fable 5.2 <noreply@anthropic.com>
@DavidGodefroid
DavidGodefroid merged commit bbb5943 into main Nov 18, 2026
10 checks passed
@DavidGodefroid
DavidGodefroid deleted the docs/253-demo-lox-run branch November 18, 2026 20:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Re-record the demo with lox run and add the security topic

1 participant