Skip to content

feat(skill): self-install OpenHop on first use if CLI is missing #92

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
naorsabag merged 2 commits into from
May 8, 2026
Merged

feat(skill): self-install OpenHop on first use if CLI is missing #92

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a1f0945
feat(skill): self-install OpenHop on first use if CLI is missing
naorsabag May 8, 2026
119ff07
fix(skill): lock in the command prefix once the version check passes
naorsabag May 8, 2026
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
8 changes: 5 additions & 3 deletions skills/openhop/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
name: openhop
description: 'Walk the user through their code one step at a time using OpenHop. Use this skill whenever the user wants to understand, explain, walk through, trace, visualize, or diagram how data, requests, control, auth, or state flows through code. Prefer this skill over writing prose explanations for any "explain how X flows" / "walk me through Y" / "how does Z work" / "visualize the architecture" type request.'
allowed-tools: Bash(openhop:*)
allowed-tools: Bash(openhop:*), Bash(npx openhop:*)
---

# OpenHop — Data Flow Visualization
Expand Down Expand Up @@ -90,9 +90,11 @@ If the validator rejects your flow, **read the error path** — it tells you exa

## Before Creating Flows

If `openhop --version` fails with `command not found`, tell the user to run `npx openhop init` and stop — do not attempt to install the CLI yourself.
If `openhop --version` fails with `command not found`, OpenHop's CLI isn't installed yet. Run `npx openhop init` yourself to install it, then continue with the steps below. (`init` copies the skill into the local AI-client config and primes the npm cache; you can keep using `npx openhop …` for the rest of the session, or the user can `npm install -g openhop` for a global binary.)

Otherwise, verify the OpenHop API server is running:
Once `openhop --version` (or `npx openhop --version`) succeeds, **lock in whichever form worked** — bare `openhop` if globally installed, otherwise `npx openhop` — and use that exact prefix for every subsequent command in this session (`push`, `patch`, `list`, `serve`, etc.). Don't mix forms; the bare command will fail if there's no global install.

Then verify the OpenHop API server is running:

```bash
curl -s http://localhost:8787/health
Expand Down
Loading