Skip to content

ythx-101/live-panel-skill

live-panel

Verified

Build a terminal-style, always-running animated architecture diagram (a "live panel") from a JSON config and render it to an mp4. Use when the user wants a system, agent or org architecture diagram that looks like a monitoring dashboard in a terminal window - fixed layout, glowing packets on the wires, scrolling log, counters, bars that flip state - as a screen-recording-style video or a live web page, instead of a static picture or a step-by-step reveal. 中文:当用户要做"活的"架构图、agent 树或系统监控面板风格的动画(mp4 视频或循环网页)时使用——终端里一直在跑的监控面板外观,固定布局、线上流动的数据包、滚动日志、翻转的计数器和状态条;不是静态图,也不是分步演示。

FileKindSize
SKILL.mdskill md11.2 KB
assets/fonts/Excalifont-OFL.txtmarkdown5.1 KB
assets/fonts/Excalifont-Regular-Latin.woff2binary24.4 KB
assets/fonts/SmileySans-OFL.txtmarkdown4.3 KB
assets/fonts/SmileySans-Oblique.woff2binary1.1 MB
assets/fonts/Xiaolai-OFL.txtmarkdown4.3 KB
assets/template.htmlother35.9 KB
assets/views/LUCIDE-LICENSE.txtmarkdown3.1 KB
assets/views/ROUGH-LICENSE.txtmarkdown1.0 KB
assets/views/excalidraw.jsscript50.0 KB
assets/views/funnel.jsscript15.5 KB
assets/views/loop.jsscript74.3 KB
assets/views/ring.jsscript15.2 KB
assets/views/sketchboard.jsscript18.7 KB
examples/agent-architecture/agent-architecture.mp4binary1.4 MB
examples/agent-architecture/config.jsonconfig37.1 KB
examples/agent-architecture/preview.webpbinary1.2 MB
examples/airbnb/airbnb.mp4binary1.9 MB
examples/airbnb/config.jsonconfig20.3 KB
examples/airbnb/preview.webpbinary1.4 MB
examples/codex-agents/codex-agents.mp4binary1.8 MB
examples/codex-agents/config.jsonconfig19.1 KB
examples/codex-agents/preview.webpbinary1.6 MB
examples/excalidraw-aqua/README.mdmarkdown760 B
examples/excalidraw-aqua/build_config.pyscript6.6 KB
examples/excalidraw-aqua/config-3x4.jsonconfig8.3 KB
examples/excalidraw-aqua/config-4x5.jsonconfig8.3 KB
examples/excalidraw-aqua/preview.webpbinary2.3 MB
examples/excalidraw-gardener/README.mdmarkdown671 B
examples/excalidraw-gardener/build_config.pyscript6.4 KB
examples/excalidraw-gardener/config-3x4.jsonconfig7.6 KB
examples/excalidraw-gardener/config-4x5.jsonconfig7.6 KB
examples/excalidraw-gardener/preview.webpbinary1.2 MB
examples/excalidraw-import/agent-loop.excalidrawother6.7 KB
examples/excalidraw-import/agent-loop.mp4binary1.6 MB
examples/excalidraw-import/config.jsonconfig3.9 KB
examples/funnel-karpathy/config.jsonconfig1.2 KB
examples/funnel/config.jsonconfig1.2 KB
examples/funnel/funnel.mp4binary1.1 MB
examples/funnel/preview.webpbinary475.3 KB
examples/hybrid-agent/README.mdmarkdown729 B
examples/hybrid-agent/config.jsonconfig6.2 KB
examples/loop-poteto/config.jsonconfig6.6 KB
examples/loop-poteto/loop-poteto.mp4binary2.1 MB
examples/loop-poteto/preview-dark.webpbinary638.3 KB
examples/loop-poteto/preview-light.webpbinary627.2 KB
examples/minimal/config.jsonconfig1.9 KB
examples/minimal/preview.webpbinary146.3 KB
examples/ring/config.jsonconfig940 B
examples/ring/preview.webpbinary150.9 KB
examples/ring/ring.mp4binary593.1 KB
references/config-schema.mdmarkdown4.9 KB
references/motion-grammar.mdmarkdown6.4 KB
references/verify-view.mdmarkdown3.3 KB
references/view-rules.mdmarkdown4.3 KB
references/views.mdmarkdown24.7 KB
scripts/check_frames.pyexecutablescript4.6 KB
scripts/excalidraw_import.pyscript14.7 KB
scripts/fetch_fonts.shexecutablescript528 B
scripts/livepanel.pyexecutablescript10.2 KB
scripts/render.pyexecutablescript3.8 KB
scripts/scaffold.pyexecutablescript25.0 KB
scripts/verify_view.pyscript28.5 KB

scripts/livepanel.py

View on GitHub
"""Shared helpers: build the page from template + config, and drive Chrome over the DevTools pipe (standard library only)."""
import base64, json, os, shutil, subprocess, sys, tempfile, time
from pathlib import Path

ROOT = Path(__file__).resolve().parent.parent
DEFAULT_TEMPLATE = ROOT / "assets" / "template.html"
CHROME_NAMES = ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser", "chrome", "microsoft-edge"]
# On macOS the browser lives inside an .app bundle, not on PATH. Homebrew's `chromium` shim on PATH launches
# and then dies on the DevTools pipe, so real bundles are preferred over anything shutil.which() would find.
CHROME_MAC_PATHS = [
    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
    "/Applications/Chromium.app/Contents/MacOS/Chromium",
    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
    "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
]


def find_exe(explicit, names, what):
    if explicit:
        p = shutil.which(explicit) or (explicit if os.path.exists(explicit) else None)
        if p:
            return p
        sys.exit(f"{what} not found: {explicit}")
    for n in names:
        p = shutil.which(n)
        if p:
            return p
    sys.exit(f"{what} not found on PATH (tried {', '.join(names)}); pass it explicitly")


def find_chrome(explicit):
    """Chrome lookup: an explicit path wins, then macOS .app bundles, then the PATH names in CHROME_NAMES."""
    if explicit:
        return find_exe(explicit, CHROME_NAMES, "Chrome")
    if sys.platform == "darwin":
        for p in CHROME_MAC_PATHS:
            if os.path.exists(p):
                return p
    return find_exe(None, CHROME_NAMES, "Chrome")


CANVAS_PRESETS = {"4:5": (1200, 1500), "3:4": (1080, 1440), "1:1": (1080, 1080)}


def canvas(cfg):
    """(width, height, duration, fps) from a config, honouring canvas.preset."""
    cv = cfg.get("canvas", {})
    pw, ph = CANVAS_PRESETS.get(cv.get("preset"), (1200, 1500))
    return cv.get("width", pw), cv.get("height", ph), cv.get("duration", 30), cv.get("fps", 30)


def load_config(path):
    with open(path, encoding="utf-8") as f:
        return json.load(f)


def views_html():
    """Every assets/views/*.js (sorted, '_' prefix skipped) as inline <script> tags, so the page stays self-contained."""
    d = ROOT / "assets" / "views"
    if not d.is_dir():
        return ""
    out = []
    for f in sorted(d.glob("*.js")):
        if f.name.startswith("_"):
            continue
        out.append("<script>/* view: %s */\n%s\n</script>" % (f.name, f.read_text(encoding="utf-8").replace("</script", "<\\/script")))
    return "\n".join(out)


def _font_face(family, path, weight, chars, subset_ok=True):
    """One @font-face rule with the font file inlined as a data URL. A TTF/OTF over 400 KB (a full CJK font) is
    subset to the characters the config actually uses when fontTools is installed, so the page stays small."""
    import base64
    data = Path(path).read_bytes()
    ext = Path(path).suffix.lower()
    fmt = {".woff2": "woff2", ".woff": "woff", ".otf": "opentype"}.get(ext, "truetype")
    if subset_ok and chars and fmt in ("truetype", "opentype") and len(data) > 400_000:
        try:
            import io
            from fontTools import subset
            opts = subset.Options(); opts.flavor = "woff"; opts.layout_features = ["*"]
            font = subset.load_font(path, opts)
            sub = subset.Subsetter(opts); sub.populate(text=chars); sub.subset(font)
            buf = io.BytesIO(); subset.save_font(font, buf, opts); data, fmt = buf.getvalue(), "woff"
            font.close()  # fontTools keeps the source open; leaked fds push render.py's Chrome pipes past fd 9, which sh cannot redirect
        except ImportError:
            print(f"note: fontTools not installed, embedding all of {path} ({len(data) // 1024} KB)", file=sys.stderr)
    mime = {"woff2": "font/woff2", "woff": "font/woff", "opentype": "font/otf", "truetype": "font/ttf"}[fmt]
    b64 = base64.b64encode(data).decode("ascii")
    return ('@font-face{font-family:"%s";src:url(data:%s;base64,%s) format("%s");font-weight:%s;font-display:block}'
            % (family, mime, b64, fmt, weight or "100 900"))


def fonts_html(cfg, base_dir=None):
    """Embed fonts as data URLs: Smiley Sans (得意黑, OFL) when theme.titleFont == "smiley", and every entry of
    theme.fonts ([{family, src, weight?}], src relative to the config file) so a custom look (e.g. the hand-drawn
    sketch theme) stays one self-contained page."""
    th = cfg.get("theme") or {}
    rules = []
    if th.get("titleFont") == "smiley":
        f = ROOT / "assets" / "fonts" / "SmileySans-Oblique.woff2"
        rules.append(_font_face("Smiley Sans", str(f), None, "", subset_ok=False))
    if th.get("fonts"):
        chars = "".join(sorted(set(json.dumps(cfg, ensure_ascii=False)) | set(map(chr, range(32, 127))) | set("…·—–×→←↑↓✓“”‘’():,。、;?!「」《》")))
        for f in th["fonts"]:
            src = Path(f["src"])
            if not src.is_absolute():
                cand = [Path(base_dir or ".") / src, ROOT / "assets" / "fonts" / src]
                src = next((c for c in cand if c.exists()), cand[0])
            if not src.exists():
                print(f"note: theme.fonts: {f['src']} not found, falling back to the next font in theme.font", file=sys.stderr)
                continue
            rules.append(_font_face(f["family"], str(src), f.get("weight"), chars))
    return "<style>%s</style>" % "".join(rules) if rules else ""


def build_page(config_path, out_path, template=None):
    """Write a self-contained HTML file: template with the JSON config embedded. Returns the config dict."""
    cfg = load_config(config_path)
    tpl = Path(template or DEFAULT_TEMPLATE).read_text(encoding="utf-8")
    blob = json.dumps(cfg, ensure_ascii=False).replace("</", "<\\/")
    tag = f'<script id="live-config" type="application/json">{blob}</script>'
    if "<!--LIVE_CONFIG-->" not in tpl:
        sys.exit("template has no <!--LIVE_CONFIG--> placeholder")
    page = tpl.replace("<!--LIVE_CONFIG-->", tag)
    page = page.replace("<!--LIVE_VIEWS-->", views_html()).replace("<!--LIVE_FONTS-->", fonts_html(cfg, Path(config_path).resolve().parent))
    Path(out_path).write_text(page, encoding="utf-8")
    return cfg


class Chrome:
    """Headless Chrome driven through --remote-debugging-pipe (no websocket, no third-party packages)."""

    def __init__(self, chrome, width, height, no_sandbox=None):
        self.tmp = tempfile.mkdtemp(prefix="livepanel-")
        r1, w1 = os.pipe()   # we write -> chrome fd 3
        r2, w2 = os.pipe()   # chrome fd 4 -> we read
        args = [chrome, "--headless=new", "--remote-debugging-pipe", f"--user-data-dir={self.tmp}", "--no-first-run",
                "--disable-gpu", "--hide-scrollbars", "--force-device-scale-factor=1", "--font-render-hinting=none",
                "--allow-file-access-from-files", "--disable-background-timer-throttling", "--mute-audio", "about:blank"]
        if no_sandbox or (no_sandbox is None and hasattr(os, "geteuid") and os.geteuid() == 0):
            args.insert(1, "--no-sandbox")
        env = dict(os.environ, LP_R=str(r1), LP_W=str(w2))
        self.proc = subprocess.Popen(["sh", "-c", 'exec "$@" 3<&"$LP_R" 4>&"$LP_W"', "sh"] + args, pass_fds=(r1, w2), env=env,
                                     stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
        os.close(r1); os.close(w2)
        self.wf = os.fdopen(w1, "wb", buffering=0); self.rf = os.fdopen(r2, "rb", buffering=0)
        self.buf = b""; self.n = 0
        tid = self.call("Target.createTarget", {"url": "about:blank"})["targetId"]
        self.sid = self.call("Target.attachToTarget", {"targetId": tid, "flatten": True})["sessionId"]
        self.cmd("Page.enable")
        self.cmd("Emulation.setDeviceMetricsOverride", {"width": width, "height": height, "deviceScaleFactor": 1, "mobile": False})

    def call(self, method, params=None, session=None):
        self.n += 1
        msg = {"id": self.n, "method": method, "params": params or {}}
        if session:
            msg["sessionId"] = session
        self.wf.write(json.dumps(msg).encode() + b"\0")
        while True:
            while b"\0" not in self.buf:
                chunk = os.read(self.rf.fileno(), 1 << 20)
                if not chunk:
                    raise RuntimeError("Chrome closed the pipe")
                self.buf += chunk
            raw, self.buf = self.buf.split(b"\0", 1)
            m = json.loads(raw)
            if m.get("id") == self.n:
                if "error" in m:
                    raise RuntimeError(f"{method}: {m['error']}")
                return m.get("result", {})

    def cmd(self, method, params=None):
        return self.call(method, params, self.sid)

    def eval(self, expr):
        r = self.cmd("Runtime.evaluate", {"expression": expr, "returnByValue": True, "awaitPromise": True})
        if "exceptionDetails" in r:
            raise RuntimeError(f"js error: {r['exceptionDetails']}")
        return r["result"].get("value")

    def open(self, url, timeout=20):
        self.cmd("Page.navigate", {"url": url})
        t0 = time.time()
        while time.time() - t0 < timeout:
            try:
                if self.eval("window.__ready===true"):
                    err = self.eval("window.__error||''")
                    if err:
                        raise RuntimeError("page error: " + err)
                    return
                err = self.eval("window.__error||''")
                if err:
                    raise RuntimeError("page error: " + err)
            except RuntimeError as e:
                if "page error" in str(e):
                    raise
            time.sleep(0.1)
        raise RuntimeError("page did not become ready (check the config JSON)")

    def seek(self, t):
        self.eval(f"window.seek({t!r})")

    def shot(self):
        return base64.b64decode(self.cmd("Page.captureScreenshot", {"format": "png"})["data"])

    def close(self):
        try:
            self.proc.terminate(); self.proc.wait(5)
        except Exception:
            self.proc.kill()
        shutil.rmtree(self.tmp, ignore_errors=True)

    def __enter__(self):
        return self

    def __exit__(self, *a):
        self.close()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall