Skip to content

Package: yeetkit from the sibling checkout, not /home/jrg - #3

Merged
necco-c merged 1 commit into
mainfrom
readme-run-it
Oct 7, 2026
Merged

necco-c merged 1 commit into
mainfrom
readme-run-it

Conversation

@necco-c

@necco-c necco-c commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Points the yeetkit dependency at the sibling checkout (file:../yeetkit) instead of file:/home/jrg/src/yeetkit.

Why

We ran cold coding agents on a fresh Debian 13 VM with the prompt "install yeet, then start up httpscope and show me it working." Every one of them hit npm install failing on the absolute path, then cloned yeetkit next to httpscope and rewrote the path to ../yeetkit by hand.

Change

  • package.json: "yeetkit": "file:../yeetkit".
  • package-lock.json: the root entry says the same. The lockfile already resolved node_modules/yeetkit to ../yeetkit, so nothing changes for your layout (~/src/httpscope next to ~/src/yeetkit).
  • Verified: npm install --package-lock-only leaves the lockfile untouched.

Not in this PR (yeetkit)

  • Node 20. yeetkit's bridge.mjs uses the global WebSocket, which Node 20 keeps behind --experimental-websocket. Importing WebSocket from ws, which it already depends on, would remove the need for the flag.
  • Bind loopback. dev.mjs calls server.listen(port) with no host, so the dev server binds every interface. Passing "127.0.0.1" by default would stop captured traffic from being reachable over the network.
  • Hub retry. createHub retries only on close, and its error listener is empty. When the first connect fails at startup, every request hangs. This is intermittent.

The lockfile already resolves yeetkit as ../yeetkit; package.json now
says the same, so npm install works from any fresh clone that has
yeetkit next to it.
@necco-c necco-c changed the title Docs: how to run it from a fresh clone Package: yeetkit from the sibling checkout, not /home/jrg Oct 7, 2026
@necco-c
necco-c merged commit 4c9e3e7 into main Oct 7, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant