crux-cockpit skillA
crux-cockpit is agent-read markdown (skill) from mehdiforoozandeh/crux: Launch and manage the crux cockpit — the read-only browser GUI over a crux research vault (`crux serve`). This skill runs it beginning to finish: locate the vault, start the server fresh on localhost, verify it actually serves, and hand the user one clickable URL — plus status / stop / restart, and a setup-or-demo path when no vault exists yet. Works wherever the agent runs: local machine, VS Code Remote-SSH (drives the port forward itself via `code --openExternal`), or a plain SSH terminal (han.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# crux-cockpit — launch the crux GUI, beginning to finish The **cockpit** is crux's read-only browser GUI: `crux serve` boots a stdlib HTTP server on `127.0.0.1`, serves the `webui/` frontend, and exposes the vault as `/snapshot.json` (status-colored tree — pan / zoom / collapse / search / re-orient / focus one question — plus the review queue, node detail with rendered markdown, and a hypothesis's linked report and figures; live-refreshing, zero writes). Either panel can go full-screen (`[` / `]`, `Esc` restores). The engine does the serving; **you (the agent) do the operating**: find the vault, launch clean, verify, hand over one URL, and manage the server's lifecycle. The user should never have to touch a terminal **on the machine you run on** — the one thing you can't do for them is start a local `ssh -L` tunnel (plain-SSH contexts only; see **Local vs remote**). The engine rides in the **crux** skill: `ENGINE = <crux skill>/scaffold/crux.py` — the crux skill is this skill's sibling directory in your skills dir (in a repo clone, `skills/crux`). If that engine file is missing, the crux skill isn't installed: install …
Read the whole file at its exact version.
How to install
mdr add mehdiforoozandeh/crux/crux-cockpit@v1.0mdr add mehdiforoozandeh/crux/crux-cockpit@sha256:ab41eb76233703a9Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_znbzczrm7ebxatck)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0 latest | 2026-07-25 | 014e7b6 | 17,260 B | A | view · diff |
| v1.0 | 2026-07-14 | 48eab68 | 17,112 B | A | view · diff |
| v1.0 | 2026-07-11 | 77c4ac2 | 16,793 B | A | view · diff |
| v1.0 | 2026-07-11 | b7dac49 | 15,545 B | A | view · diff |
| v1.0 | 2026-07-11 | 5aec71e | 6,834 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (17260 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
mehdiforoozandeh/crux · 6 stars · license MIT · pushed 2026-09-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_znbzczrm7ebxatck GET https://markdownregistry.com/api/v1/resolve?ref=mehdiforoozandeh/crux/crux-cockpit GET https://markdownregistry.com/api/v1/blob/ab41eb76233703a9ffecb480191dfe444d735a05692a5ad436b825bc8aa2d04a
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.