diff --git a/README.md b/README.md index 24aee02..490f40c 100644 --- a/README.md +++ b/README.md @@ -16,9 +16,9 @@ connections and writes wait for you, and the agent never holds a password.

- Demo: an agent (here Claude Code, left) asks for the top Belgian customers; the locksql console (right) shows each query for approval. The agent gets names and emails masked. + Demo, two terminals side by side. 1. Left, an agent (here Claude Code) is asked for the 3 Belgian customers with the highest total spend, with their name and email. 2. The agent plans a query through locksql and says it is pending. 3. Right, lox run (here in manual mode) shows the ticket as a question: the SQL, class READ, masked columns email and name. 4. The human presses y in lox run, then tells the agent it is approved. 5. The agent runs the ticket and shows three rows whose name and email are <redacted>.

-

An agent (here Claude Code, left) and the locksql console (right). Recorded before approvals moved to lockhub: today you answer in lox run, and masked cells come back as plain <redacted>.

+

An agent (here Claude Code, left) and lox run (right, in manual mode: every ticket is asked).

Quick start · diff --git a/docs/assets/demo.gif b/docs/assets/demo.gif index f3cabe2..7f194d6 100644 Binary files a/docs/assets/demo.gif and b/docs/assets/demo.gif differ diff --git a/scripts/demo/rec.py b/scripts/demo/rec.py new file mode 100644 index 0000000..143d909 --- /dev/null +++ b/scripts/demo/rec.py @@ -0,0 +1,15 @@ +#!/usr/bin/env python3 +"""Records the two panes of tmux window demo253:rec: one JSON line per changed screen (real text, colours, timing).""" +import json, subprocess, sys, time, os +out, stop = sys.argv[1], sys.argv[1] + ".stop" +def cap(p): + s = subprocess.run(["tmux", "capture-pane", "-e", "-p", "-t", f"demo253:rec.{p}"], capture_output=True, text=True).stdout + c = subprocess.run(["tmux", "display", "-p", "-t", f"demo253:rec.{p}", "#{cursor_x},#{cursor_y},#{cursor_flag}"], capture_output=True, text=True).stdout.strip() + return s, c +t0 = time.time(); last = None +with open(out, "w") as f: + while not os.path.exists(stop): + fr = [cap(0), cap(1)] + if fr != last: + f.write(json.dumps({"t": round(time.time() - t0, 2), "p": fr}) + "\n"); f.flush(); last = fr + time.sleep(0.08) diff --git a/scripts/demo/render.py b/scripts/demo/render.py new file mode 100644 index 0000000..9013d51 --- /dev/null +++ b/scripts/demo/render.py @@ -0,0 +1,139 @@ +#!/usr/bin/env python3 +"""Renders a rec.py recording (tmux screens with SGR colours) to PNG frames + an ffmpeg concat list.""" +import json, re, sys, os, hashlib +from PIL import Image, ImageDraw, ImageFont +src, outdir = sys.argv[1], sys.argv[2] +T0 = float(sys.argv[3]) if len(sys.argv) > 3 else 0.0 # start of the kept span (s) +T1 = float(sys.argv[4]) if len(sys.argv) > 4 else 1e9 +os.makedirs(outdir, exist_ok=True) +CW, CH, FS = 9.7, 21, 16 +COLS = (79, 92); ROWS = 42 +PAD, TITLE = 16, 34 +W = int(round(PAD * 2 + (COLS[0] + 1 + COLS[1]) * CW)); H = TITLE + ROWS * CH + PAD + 8 +W += W % 2; H += H % 2 +BG, FG = (0x1a, 0x18, 0x14), (0xe6, 0xe1, 0xd6) +PAL = [(0x3a,0x36,0x2e),(0xff,0x93,0x84),(0x7f,0xcf,0x8a),(0xe8,0xb8,0x60),(0x89,0xb4,0xfa),(0xc4,0xa7,0xe7),(0x6f,0xd9,0xc8),(0xd8,0xd2,0xc4), + (0x7a,0x73,0x64),(0xff,0xa8,0x9c),(0x9c,0xe0,0xa5),(0xf2,0xcd,0x85),(0xa3,0xbd,0xff),(0xd6,0xbf,0xf2),(0x8f,0xe8,0xd9),(0xf4,0xef,0xe4)] +def c256(n): + if n < 16: return PAL[n] + if n < 232: + n -= 16; v = [0, 95, 135, 175, 215, 255]; return (v[n // 36], v[n // 6 % 6], v[n % 6]) + g = 8 + (n - 232) * 10; return (g, g, g) +D = "/usr/share/fonts/truetype/dejavu/" +F = {(0, 0): ImageFont.truetype(D + "DejaVuSansMono.ttf", FS), (1, 0): ImageFont.truetype(D + "DejaVuSansMono-Bold.ttf", FS), + (0, 1): ImageFont.truetype(D + "DejaVuSansMono-Oblique.ttf", FS), (1, 1): ImageFont.truetype(D + "DejaVuSansMono-BoldOblique.ttf", FS)} +N = "/usr/share/fonts/truetype/" +FALL = [ImageFont.truetype(N + p, FS) for p in ("noto/NotoSansSymbols2-Regular.ttf", "noto/NotoSansSymbols-Regular.ttf", "freefont/FreeMono.ttf")] +EMO = ImageFont.truetype(N + "noto/NotoColorEmoji.ttf", 109) +_ec = {} +def emoji(ch): + if ch not in _ec: + im = Image.new("RGBA", (136, 128), (0, 0, 0, 0)); ImageDraw.Draw(im).text((0, 0), ch, font=EMO, embedded_color=True) + _ec[ch] = im.resize((17, 16), Image.LANCZOS) + return _ec[ch] +SCRUB = (re.compile(r"(?<=Sonnet \d\.\d) · Claude \w+"), re.compile(r" · ← \d+ agents?")) # the recording account's plan and session count, blanked +HIDE = ("Your login expires", "tmux focus-events off") # notices of the recording machine (account, tmux tip), blanked +UI = ImageFont.truetype(D + "DejaVuSansMono.ttf", 14) +_hc = {} +def _bits(font, ch): + im = Image.new("L", (40, 40), 0); ImageDraw.Draw(im).text((4, 4), ch, font=font, fill=255); return im.tobytes() +def has(font, ch): + k = (id(font), ch) + if k not in _hc: _hc[k] = _bits(font, ch) not in (_bits(font, "\U000fffff"), _bits(font, " ")) + return _hc[k] +SGR = re.compile(r"\x1b\[([0-9;:]*)m|\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)|\x1b\[[0-9;?]*[A-Za-z]|[\x0e\x0f]") +def parse(text): + rows = [] + st = dict(fg=None, bg=None, b=0, d=0, i=0, u=0, r=0) + for line in text.split("\n")[:ROWS]: + if any(h in line for h in HIDE): line = "" + cells = []; pos = 0 + for m in SGR.finditer(line): + for ch in line[pos:m.start()]: cells.append((ch, dict(st))) + pos = m.end() + if m.group(1) is None: continue + ps = [int(x) if x else 0 for x in re.split("[;:]", m.group(1))] if m.group(1) else [0] + k = 0 + while k < len(ps): + p = ps[k] + if p == 0: st = dict(fg=None, bg=None, b=0, d=0, i=0, u=0, r=0) + elif p == 1: st["b"] = 1 + elif p == 2: st["d"] = 1 + elif p == 3: st["i"] = 1 + elif p == 4: st["u"] = 1 + elif p == 7: st["r"] = 1 + elif p == 22: st["b"] = st["d"] = 0 + elif p == 23: st["i"] = 0 + elif p == 24: st["u"] = 0 + elif p == 27: st["r"] = 0 + elif 30 <= p <= 37: st["fg"] = PAL[p - 30] + elif 90 <= p <= 97: st["fg"] = PAL[p - 82] + elif 40 <= p <= 47: st["bg"] = PAL[p - 40] + elif 100 <= p <= 107: st["bg"] = PAL[p - 92] + elif p == 39: st["fg"] = None + elif p == 49: st["bg"] = None + elif p in (38, 48): + key = "fg" if p == 38 else "bg" + if ps[k + 1] == 5: st[key] = c256(ps[k + 2]); k += 2 + elif ps[k + 1] == 2: st[key] = tuple(ps[k + 2:k + 5]); k += 4 + k += 1 + for ch in line[pos:]: cells.append((ch, dict(st))) + plain = "".join(c for c, _ in cells) + for rx in SCRUB: + for m in rx.finditer(plain): + for k in range(m.start(), m.end()): cells[k] = (" ", cells[k][1]) + rows.append(cells) + return rows +def wide(ch): return ord(ch) >= 0x1f000 or 0x2e80 <= ord(ch) <= 0xa4cf or 0xff00 <= ord(ch) <= 0xff60 +QUAD = {"█": 15, "▀": 3, "▄": 12, "▌": 5, "▐": 10, "▘": 1, "▝": 2, "▖": 4, "▗": 8, "▛": 7, "▜": 11, "▙": 13, "▟": 14, "▚": 9, "▞": 6} +BOX = {"─": "lr", "│": "ud", "┌": "rd", "┐": "ld", "└": "ru", "┘": "lu", "├": "udr", "┤": "udl", "┬": "lrd", "┴": "lru", "┼": "lrud", + "╭": "rd", "╮": "ld", "╰": "ru", "╯": "lu", "━": "LR", "╌": "lr"} +def draw_pane(im, d, text, x0, y0): + for r, cells in enumerate(parse(text)): + xf = x0; y = y0 + r * CH + for ch, st in cells: + x = int(round(xf)); x2 = int(round(xf + CW * (2 if wide(ch) else 1))); cw = x2 - x + w = 2 if wide(ch) else 1 + fg, bg = st["fg"] or FG, st["bg"] or BG + if st["r"]: fg, bg = bg, fg + if st["d"]: fg = tuple((a + b) // 2 for a, b in zip(fg, bg)) + if bg != BG: d.rectangle([x, y, x2 - 1, y + CH - 1], fill=bg) + if ch in QUAD: + q = QUAD[ch]; hx, hy = cw // 2, CH // 2 + for bit, (ax, ay, bx, by) in zip((1, 2, 4, 8), ((0, 0, hx, hy), (hx, 0, cw, hy), (0, hy, hx, CH), (hx, hy, cw, CH))): + if q & bit: d.rectangle([x + ax, y + ay, x + bx - 1, y + by - 1], fill=fg) + elif ch in BOX: + s = BOX[ch]; cx, cy = x + cw // 2, y + CH // 2; t = 3 if s.isupper() else 1; s = s.lower() + if "l" in s: d.line([x, cy, cx, cy], fill=fg, width=t) + if "r" in s: d.line([cx, cy, x2, cy], fill=fg, width=t) + if "u" in s: d.line([cx, y, cx, cy], fill=fg, width=t) + if "d" in s: d.line([cx, cy, cx, y + CH], fill=fg, width=t) + elif ord(ch) >= 0x1f000: + im.paste(emoji(ch), (x + 1, y + 3), emoji(ch)) + elif ch not in "  ": + f = F[(st["b"], st["i"])] + if not has(f, ch): + f = next((g for g in FALL if has(g, ch)), f) + d.text((x, y + 1), ch, font=f, fill=fg) + if st["u"]: d.line([x, y + CH - 3, x2 - 1, y + CH - 3], fill=fg) + xf += CW * w +def frame(rec): + im = Image.new("RGB", (W, H), BG); d = ImageDraw.Draw(im) + xs = (PAD, PAD + (COLS[0] + 1) * CW) + sep = int(PAD + COLS[0] * CW + CW / 2) + d.line([sep, 0, sep, H], fill=(0x4a, 0x44, 0x38)) + d.line([0, TITLE - 8, W, TITLE - 8], fill=(0x4a, 0x44, 0x38)) + for x, label in zip(xs, ("the agent · Claude Code", "you · lox run, in a terminal of its own")): + d.text((x, 6), label, font=UI, fill=(0xb9, 0xaf, 0x98)) + for p in (0, 1): draw_pane(im, d, rec["p"][p][0], xs[p], TITLE) + return im +recs = [json.loads(l) for l in open(src)] +recs = [r for r in recs if T0 <= r["t"] <= T1] +lines = []; n = 0 +for i, r in enumerate(recs): + dur = (recs[i + 1]["t"] - r["t"]) if i + 1 < len(recs) else 4.0 + fn = f"{outdir}/f{n:05d}.png"; frame(r).save(fn); n += 1 + lines.append(f"file '{os.path.abspath(fn)}'\nduration {dur:.2f}\n") +lines.append(f"file '{os.path.abspath(fn)}'\n") +open(f"{outdir}/concat.txt", "w").write("".join(lines)) +print(n, "frames", W, "x", H, "span", recs[0]["t"], recs[-1]["t"]) diff --git a/scripts/demo/take.sh b/scripts/demo/take.sh new file mode 100644 index 0000000..f604f75 --- /dev/null +++ b/scripts/demo/take.sh @@ -0,0 +1,37 @@ +#!/bin/bash +# One take of the README/site demo: a real run, recorded from tmux. +# +# Before: a workspace with one locksql lock on a throwaway database +# (`lox add locksql`), and a tmux session `demo253` whose window `rec` has +# two panes of 79 and 92 columns, 42 rows: pane 0 a shell in the workspace +# (the agent goes there), pane 1 `lox run --manual` with the lock serving +# (console started with `lox attach` in another window). lox, the locksql +# launcher and the lock's image must be the same release. +# +# bash take.sh take.jsonl # types the question, approves in lox run +# python3 render.py take.jsonl fr # one PNG per screen + fr/concat.txt +# ffmpeg -f concat -safe 0 -i fr/concat.txt -vf fps=25,format=yuv420p -c:v libx264 -crf 24 -movflags +faststart demo.mp4 +# ffmpeg -f concat -safe 0 -i fr/concat.txt -vf fps=25,format=yuv420p -c:v libvpx-vp9 -crf 36 -b:v 0 demo.webm +# ffmpeg -f concat -safe 0 -i fr/concat.txt -vf "fps=10,scale=1400:-1:flags=lanczos,split[a][b];[a]palettegen=max_colors=64:stats_mode=diff[p];[b][p]paletteuse=dither=none:diff_mode=rectangle" demo.gif +# +# rec.py stores the panes' text, colours and timing; render.py draws them +# (DejaVu Sans Mono, the site's terminal colours) and blanks only the lines +# listed in its HIDE (notices of the recording machine). +cd "$(dirname "$0")"; L=demo253:rec.0; R=demo253:rec.1; out=${1:-take.jsonl} +left() { tmux capture-pane -t $L -p; }; right() { tmux capture-pane -t $R -p; } +idle() { ! left | grep -q 'esc to interrupt'; } +tmux send-keys -t $L "clear; claude --setting-sources project,local --model sonnet" Enter +for _ in $(seq 1 30); do left | grep -q 'auto mode on' && break; sleep 1; done; sleep 4 +rm -f "$out.stop"; python3 rec.py "$out" & sleep 2.5 +msg='In the dev database: our 3 Belgian customers with the highest total spend, with their name and email.' +for ((i=0;i<${#msg};i++)); do tmux send-keys -t $L -l "${msg:$i:1}"; sleep 0.045; done +sleep 0.9; tmux send-keys -t $L Enter +for _ in $(seq 1 90); do right | grep -q 'QUESTION read' && break; sleep 1; done +sleep 6; tmux send-keys -t $R d; sleep 8; tmux send-keys -t $R y; sleep 3 +for _ in $(seq 1 60); do idle && break; sleep 1; done; sleep 2 +if ! left | grep -q ' *│'; then # the agent stopped at "pending": tell it the ticket is decided + msg='Approved.'; for ((i=0;i<${#msg};i++)); do tmux send-keys -t $L -l "${msg:$i:1}"; sleep 0.08; done + sleep 0.7; tmux send-keys -t $L Enter; sleep 3 +fi +for _ in $(seq 1 90); do idle && break; sleep 1; done +sleep 6; touch "$out.stop"; wait; echo "take done: $(wc -l < "$out") screens" diff --git a/site/assets/demo-poster.jpg b/site/assets/demo-poster.jpg index 0a49987..c501e8c 100644 Binary files a/site/assets/demo-poster.jpg and b/site/assets/demo-poster.jpg differ diff --git a/site/assets/demo.mp4 b/site/assets/demo.mp4 index ea309a3..211b14a 100644 Binary files a/site/assets/demo.mp4 and b/site/assets/demo.mp4 differ diff --git a/site/assets/demo.webm b/site/assets/demo.webm index c8805ce..6184500 100644 Binary files a/site/assets/demo.webm and b/site/assets/demo.webm differ diff --git a/site/index.html b/site/index.html index 6fd3783..9b84aca 100644 --- a/site/index.html +++ b/site/index.html @@ -96,10 +96,10 @@

See it run

-
An agent (here Claude Code, left) asks for the top Belgian customers; the locksql console (right) stops each query for approval. Recorded before approvals moved to lockhub: today you answer in lox run, and masked cells come back as plain <redacted>.
+
An agent (here Claude Code, left) asks for the top Belgian customers. Its query waits as a ticket in lox run (right, in manual mode: every ticket is asked) until you press y; the agent then gets names and emails as <redacted>.