测试与安全

d3k

vercel-labs/dev3000

Run and debug a local web app with a managed browser and a shared server/browser evidence timeline. Use when asked to develop, test, or reproduce a browser issue with d3k.

  • 862 次安装
  • 1600 星标
  • 收录于

安装命令

npx skills add https://github.com/vercel-labs/dev3000 --skill d3k

SKILL.md

d3k

Own the project's dev server and monitored browser through a small background runtime. No global d3k installation is needed. Evidence stays in bounded memory; browser authentication stays in the project Chrome profile.

Use node <skill-directory>/scripts/runtime.mjs as runtime below, from the target project root. In a development checkout the helper runs the source with Bun; installed skills use the JavaScript package through pnpm dlx (Node.js 24+ and pnpm required). Package acquisition runs in an isolated temporary directory so the target app’s pnpm workspace settings do not affect it; runtime commands still run against the target project. To try unreleased source from another project, set D3K_RUNTIME_ROOT to the dev3000 checkout. Do not use a previously published package to test unreleased changes.

Prepare

  1. Run runtime portless status. Canonical HTTPS must be ready (canonical: true, serviceInstalled: true, setupRequired: false) before starting the app or browser. If needed run runtime portless setup, wait for the one-time administrator authorization, then check again. Stop if setup is unavailable; never silently substitute direct localhost.
  2. Run runtime status. Reuse a ready runtime for this project. If it is starting, wait for readiness. Do not start another dev server.
  3. Start runtime start in a retained background tool session. Keep its process handle. The runtime detects the package manager and dev script; use --command '<dev command>' when needed. Poll runtime status until ready: true and browserConnected: true with a port-free https://...localhost URL. Inspect runtime events if startup fails while the runtime is still alive, and the retained process output if it exits.

Reproduce and inspect