Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@
connections and writes wait for you, and the agent never holds a password.</b></p>

<p align="center">
<img alt="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." src="docs/assets/demo.gif" width="900">
<img alt="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 &lt;redacted&gt;." src="docs/assets/demo.gif" width="900">
</p>
<p align="center"><sub>An agent (here Claude Code, left) and the locksql console (right). Recorded before approvals moved to lockhub: today you answer in <code>lox run</code>, and masked cells come back as plain <code>&lt;redacted&gt;</code>.</sub></p>
<p align="center"><sub>An agent (here Claude Code, left) and <code>lox run</code> (right, in manual mode: every ticket is asked).</sub></p>

<p align="center">
<a href="#quick-start">Quick start</a> ·
Expand Down
Binary file modified docs/assets/demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 15 additions & 0 deletions scripts/demo/rec.py
Original file line number Diff line number Diff line change
@@ -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)
139 changes: 139 additions & 0 deletions scripts/demo/render.py
Original file line number Diff line number Diff line change
@@ -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"])
37 changes: 37 additions & 0 deletions scripts/demo/take.sh
Original file line number Diff line number Diff line change
@@ -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 '<redacted> *│'; 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"
Binary file modified site/assets/demo-poster.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified site/assets/demo.mp4
Binary file not shown.
Binary file modified site/assets/demo.webm
Binary file not shown.
4 changes: 2 additions & 2 deletions site/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -96,10 +96,10 @@ <h2 id="demo" class="visually-hidden">See it run</h2>
<video controls autoplay muted loop playsinline preload="metadata" poster="assets/demo-poster.jpg" width="1700" height="940" aria-describedby="demo-caption">
<source src="assets/demo.webm" type="video/webm">
<source src="assets/demo.mp4" type="video/mp4">
<img src="assets/demo-poster.jpg" alt="The locksql console asking for approval of a query written by an agent (here Claude Code)" width="1700" height="940">
<img src="assets/demo-poster.jpg" alt="lox run asking for approval of a query written by an agent (here Claude Code); the personal data columns email and name are masked" width="1700" height="940">
</video>
<script>if (matchMedia("(prefers-reduced-motion: reduce)").matches) { const v = document.currentScript.previousElementSibling; v.removeAttribute("autoplay"); v.pause(); }</script>
<figcaption id="demo-caption">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 <code>lox run</code>, and masked cells come back as plain <code>&lt;redacted&gt;</code>.</figcaption>
<figcaption id="demo-caption">An agent (here Claude Code, left) asks for the top Belgian customers. Its query waits as a ticket in <code>lox run</code> (right, in manual mode: every ticket is asked) until you press <kbd>y</kbd>; the agent then gets names and emails as <code>&lt;redacted&gt;</code>.</figcaption>
</figure>
</section>

Expand Down
Loading