crux-cockpit

Solid

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 (hands the user the exact `ssh -L` tunnel command). Use when a crux user wants to see their vault in a browser. Triggers: "open the cockpit", "launch the crux GUI", "show me the tree in a browser", "serve the vault", "is the cockpit running", "stop the cockpit", "restart the cockpit", crux gui, crux cockpit.

Web & Frontend 3 stars 0 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
20
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# 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 it first (`npx skills add mehdiforoozandeh/crux --all`, or the repo's `./install.sh`) before continuing. ## Ground rules (load-bearing) - **Never report an unverified URL.** Before telling the user the cockpit is up, both `/` and `/snapshot.json` must have answered 200 from *your* curl. A URL you haven't verified does not leave your mouth. - **URL only ...

Details

Author
mehdiforoozandeh
Repository
mehdiforoozandeh/crux
Created
4 weeks ago
Last Updated
3 days ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

Web & Frontend Solid

crux

An agentic research companion — a scientific-method lab notebook for navigating large research programs. Organize work as a tree of Questions (what we don't know) and falsifiable Hypotheses (testable leaves), each with pre-registered verifiables and findings; a deterministic engine rolls results up into per-question answers, trips a human review gate, and regenerates an Obsidian-graphable META + experiments registry. Use when the user wants to run a research program rigorously: open/track research questions, design experiments as problem-statement → hypothesis → verifiables → findings, synthesize results, and update the open questions. Triggers: crux, "open a research question", "lab notebook", "hypothesis/experiment tracking", "design an experiment", "what should we try next", "research notebook", scientific method, meta-questions, Obsidian research vault.

3 Updated 3 days ago
mehdiforoozandeh
Data & Documents Listed

curiosity-engine

Self-improving knowledge wiki with a vault of raw sources. Use when the user mentions 'curiosity engine', 'wiki', 'vault', 'knowledge base', 'ingest', 'iterate', 'refine', 'improve', 'evolve', 'curator', 'lint', or wants to add sources, query accumulated knowledge, check wiki health, or run autonomous improvement. Also triggers on 'add to vault', 'what do I know about', 'improve wiki', 'set up knowledge base', 'new knowledge base', 'run curator'. Use even without explicit naming — if the user wants to file something for later or asks about accumulated knowledge, this is the skill.

0 Updated yesterday
benjsmith
Web & Frontend Solid

evolve-crux

Evolve crux itself — add a capability or fix a recurring flaw in the crux tool, end to end: ideate → build → validate → ship. Turns a feature idea or a "crux keeps doing X" annoyance into a signed-off PRD, a tests-first implementation, a hard validation gate (selftest green · stdlib-only · existing vaults still load · version/migration), and a pull request. Works for anyone contributing to crux, not just the maintainer; the maintainer self-merges and cuts releases. Use when working ON crux — adding to the engine/CLI/skill, picking up a ROADMAP epic (UI, wiki, marketing), or fixing an engine bug. Triggers: "evolve crux", "add a feature to crux", "crux keeps <doing X>", "improve crux", "contribute to crux", "send a crux PR", crux roadmap, wiki/GUI/autoresearch for crux.

3 Updated 3 days ago
mehdiforoozandeh