New:Microsoft Teams Notifications Are Now Available in Socket.Learn more →
Get Started

gui4cli

Package Overview
Dependencies
Maintainers
1
Versions
12
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

gui4cli

Turn a Node.js CLI script into a desktop form. Inputs, Run, live output. The original file is unchanged.

Source
npmnpm
Version
0.0.7
Version published
Weekly downloads
58
-91.27%
Maintainers
1
Weekly downloads
 
Created
Source

GUI4CLI

Turn a Node.js CLI script into a desktop form. Inputs, a Run button, and live output. The original file is unchanged.

The window is a windowd app. The first launch downloads about 200 MB of NW.js. --build writes a reusable windowd folder, not an installer.

Docs: gui4cli.dev/docs · Site: gui4cli.dev · GitHub: Catalyst-Forge-LLC/gui4cli

Install

Requires Node.js 20+. Expect a one-time NW.js download on the first window.

npx gui4cli my-script.js

Or globally:

npm install -g gui4cli
gui4cli my-script.js

A folder works too: gui4cli . --entry bin/cli.js.

What you get

  • Detects Commander and yargs (JSDoc and --help are fallbacks)
  • One window: fields, command preview, Run, live stdout/stderr, exit code
  • Remembers last-run values
  • --json prints the form and exits (CI, no GUI)
  • --build writes a reusable windowd folder that wraps the original script in place (no .exe, no rewrite)

Optional overrides: gui4cli.config.js or gui4cli.json next to the script. Flags: CLI.

Development

pnpm install
pnpm test
pnpm exec tsx src/cli.ts fixtures/resize.js --json
pnpm dev

pnpm dev opens the Commander fixture. The first windowd launch may download the NW.js runtime (~200 MB). If the window flashes and closes, run from a normal terminal, not Cursor's JavaScript Debug Terminal.

Site (FilePress): pnpm site:dev (LocalSlip gui4cli-site on 5201). Redeploy: pnpm ship.

License

MIT · Catalyst Forge LLC

Keywords

cli

FAQs

Package last updated on 14 Sep 2026

Related posts