Skip to content

Repository files navigation

plugins

Grok Build / agent marketplace plugins (installable skill + command + agent + hook packages).

Location: ~/Work/personal/plugins (not ~/plugins).
Catalog: .grok-plugin/marketplace.json

grok plugin marketplace add https://github.com/p10ns11y/plugins.git
# or local: grok plugin marketplace add ~/Work/personal/plugins
grok plugin install eva-emptiness --trust

Layers (avoid confusion)

Layer Repo / path Job Invoke
Plugin this repo (premflow/, eva-emptiness/, …) Bundle for /plugins + marketplace grok plugin install <name> --trust
Skill inside plugin skills/ (often symlinked from skills library) Procedure text agents load auto-match or /skill-name
Slash command plugin commands/*.md Thin TUI entry /eva, /note, …
Workflow .rhai ~/.grok/workflows/ or project .grok/workflows/ Host-owned background agent() phases /workflow <meta.name> · dashboard /workflows
Portable skill library p10ns11y/skills Cursor + shared procedures; workflow docs + some .rhai symlink skills; copy .rhai into Grok workflows dirs

Plugins do not auto-register Rhai. If a plugin ships .grok/workflows/*.rhai (eva-emptiness, arch-machine), you still copy (or symlink) into a discovery root. Official discovery: project <repo-root>/.grok/workflows/, user ~/.grok/workflows/ (Grok config).

skills library ──symlink──► plugin skills/     (procedure SoT for Cursor + Grok)
plugin install  ──trust───► agents, hooks, /commands
.rhai file      ──cp/ln───► ~/.grok/workflows/  (background engine)

Plugin catalog

Plugin Role Typical invoke
eva-emptiness Blank-sheet harness: Prior→Probe→Simulate→Score→ActOrAsk + prior agents + C/shell auth tether /eva · /eva-tether-init · /workflow eva-emptiness
premflow Notes/wins/tasks/coach — agent-as-CLI surface /note /focus /journal
arch-machine Thin-first sentinel + consent-gated expand — agent-as-TUI /arch-status /arch-expand
mission-map Mission briefing: critical path, heading (\hat{u}_G) / (\cos\theta), replan; C PERT/MC + Rust graph /mission-map
uncertainty-laws Napkin EV / base rate / ruin / Kelly for foggy finance & life decisions; chains after mission-map /uncertainty-laws
odysseus-navigator Judgment plane: Odysseus mistakes, antidotes, spirits; hooks CG/EVA — no tether/Rhai/priors /odysseus-core /odysseus
pulse-memory Pulse instead of dump: tagged admissions, contradiction resolve, SQLite archive vs memory /pulse-memory · /workflow pulse-memory
pstack-map Playbook map from Cursor pstack (Lauren Tan, MIT) onto house skills. No fork. /pstack-map
layout-content-view Web layout×content×view stability plus /lcv-implement for data-lcv marks. Not PNG parity. /layout-content-view /lcv-implement

eva-emptiness

Blank-sheet / epistemic emptiness. Full scenarios: eva-emptiness/README.md.

grok plugin install ./eva-emptiness --trust
# optional: secure C tether (consent) — /eva-tether-init --yes  (or: cd eva-emptiness/c && make)
cp eva-emptiness/.grok/workflows/eva-emptiness.rhai ~/.grok/workflows/   # optional background
Scenario Use
No design doc; rumors only; need plan approve /eva <goal>
Compile C auth tether (consent) /eva-tether-init --yes
Same problem, run phases in background /workflow eva-emptiness {"goal":"…"}
After Act, multi-worker delivery suggest /workflow multi-agent-delivery
Obvious bugfix skip EVA

arch-machine

grok plugin install ./arch-machine --trust
# slash: /arch-status · /arch-init · /arch-audit · /arch-expand
# optional: copy arch-machine/.grok/workflows/*.rhai → ~/.grok/workflows/

See arch-machine/README.md and arch-machine/docs/BOUNDARY.md.



uncertainty-laws

Four napkin probability laws for decisions under uncertainty (EV, base rates, ruin, Kelly). Honest exits include Wait and nothing-now. Chains after mission-map.

grok plugin install uncertainty-laws --trust
# slash: /uncertainty-laws

See uncertainty-laws/README.md.

odysseus-navigator

Judgment plane over control-graph + eva-emptiness. Diagnose hubris patterns (Cyclops leak, Sirens rewrite, Helios prod, Circe overbuild, Winds unbounded, Scylla big-bang, ignored prophecy), prescribe antidotes, gate spirits.

grok plugin install ./odysseus-navigator --trust
# slash: /odysseus-core (one bottleneck) · /odysseus (full Navigator table)

See odysseus-navigator/README.md.


pstack-map

Playbook map from Cursor pstack (Lauren Tan, MIT). Does not copy pstack. House HITL on irreversible work.

grok plugin install ./pstack-map --trust
# slash: /pstack-map
# also install pstack itself for /poteto-mode, unslop, how, why

See pstack-map/README.md and pstack-map/NOTICE.md.


layout-content-view

Routes → Viewports → Orientation → Layouts → Containers → Elements → Interactives. Measures boxes and roles, not pixels. Pilot: devprofile.

grok plugin marketplace add https://github.com/p10ns11y/plugins.git
grok plugin marketplace update
grok plugin install layout-content-view --trust
# slash: /layout-content-view

Until the catalog on the default branch lists this plugin:

grok plugin install p10ns11y/plugins@feat/layout-content-view#layout-content-view --trust

See layout-content-view/README.md.


premflow

Grok skill + slash commands for notes, wins, tasks, review, coaching, external pomo, and agent-safe journal. The plugin drives the premflow CLI; it does not ship the binary.

Plugin (this repo) premflow/ — skill, slash commands, agent helpers
CLI (separate) github.com/thecuriousts/premflow — must be on PATH
Docs premflow/README.md

1. Install the CLI

Needs: CMake 3.14+, C11 compiler, git, make. Installs to ~/.local/bin (no sudo).

git clone https://github.com/thecuriousts/premflow.git
cd premflow
./build.sh
make install

Put ~/.local/bin on PATH if it is not already:

export PATH="$HOME/.local/bin:$PATH"
# persist in your shell config, then open a new shell

Check:

command -v premflow && premflow

Alternative: finish step 2 first, then in Grok run /init (status) and, after you consent, /init --yes. Same end result: premflow on PATH.

2. Install this plugin

From a clone of this repo (plugins):

grok plugin install ./premflow --trust

Or symlink:

mkdir -p ~/.grok/plugins
ln -sfn "$(pwd)/premflow" ~/.grok/plugins/premflow

Reload Grok (or Plugins tab → r).

3. Use (slash commands only)

Command What it does
/init Check CLI on PATH
/init --yes Consent install/upgrade of CLI
/note /win /task Capture via real CLI
/review Smart daily review
/coach Coach from real ledger data only
/focus Pomo in an external TTY (never blocks agent)
/journal Ensure journal path; no $EDITOR hang

bin/pf-* scripts are agent-internal (what Grok runs for those slash commands). You do not call them from the shell for normal use.

Eval

This repo uses NVIDIA SkillEvaluator. Source is NVIDIA/SkillEvaluator. Latest notes and the verify steps are in docs/eval/2026-09-08/.

About

Grok/agent plugins. mission-map: critical path, heading, nightly graph. Pairs with kanithanj.ai.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages