Skip to content
Back to search

welsonjs-mcp

Work with WelsonJS projects and the WelsonJS MCP server, especially when planning or writing Windows automation scripts for its evaluate_js tool.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 16 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/gnh1201/welsonjs with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/gnh1201/welsonjs'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gnh1201--welsonjs/badge.svg)](/listings/gnh1201--welsonjs)

HTML

<a href="/listings/gnh1201--welsonjs"><img src="/api/listings/gnh1201--welsonjs/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Write a file `lib/sayhello.js`

// lib/sayhello.js
function say() {
    console.log("hello");
}

exports.say = say;

exports.VERSIONINFO = "SayHello (sayhello.js) version 0.1";
exports.AUTHOR = "gnh1201@catswords.re.kr";
exports.global = global;
exports.require = global.require;

2. Write a file `sayhello.js`

// sayhello.js
var SayHello = require("lib/sayhello");

function main() {
    console.log("calling say()");
    SayHello.say();
    console.log("ended say()");
}

exports.main = main;

3. Execute script on the console

C:\Users\JohnDoe\Documents\GitHub\welsonjs> cscript app.js sayhello
calling say()
hello
ended say()

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 53 lines
  1. ---
  2. name: welsonjs-mcp
  3. description: Work with WelsonJS projects and the WelsonJS MCP server, especially when planning or writing Windows automation scripts for its evaluate_js tool.
  4. metadata:
  5. short-description: Use WelsonJS through its MCP interface
  6. ---
  7. # WelsonJS MCP and project work
  8. Use this skill when a task involves this repository's `mcploader.js`, its MCP tools, or writing JavaScript to run in a WelsonJS environment. Treat the checked-in implementation as authoritative; this framework runs on Windows Script Host and exposes host capabilities, so code may interact with the user's desktop, files, processes, network, COM objects, and installed applications.
  9. ## Understand the runtime first
  10. - Read `AGENTS.md` and inspect the relevant implementation under `lib/` before relying on an API. `README.md` gives the broad project map; `mcploader.js` documents the MCP surface.
  11. - WelsonJS uses legacy WSH JScript. Prefer ES3/ES5-compatible syntax in root scripts and `lib/` unless the target file explicitly uses another engine. Do not assume Node.js APIs or modern JavaScript syntax are available.
  12. - Project modules are commonly loaded with `require("lib/<module>")`. Confirm the module's exports and host requirements before using it. Some features need Windows, COM, optional software, credentials, network access, or elevated privileges.
  13. - Each `evaluate_js` execution is independent; local variables and COM objects do not survive between calls. When a value or instance needs to be reused, save it with `_setState(key, value)` in one execution and retrieve it with `_getState(key)` in a later execution. These helpers are `null` when the JSON-RPC runtime does not provide state support, so check availability before calling them. Reacquire objects that cannot be preserved as state.
  14. ## Use the MCP tools accurately
  15. The server is a stdio JSON-RPC server exposed by `mcploader.js`. It advertises protocol version `2025-11-25`, server name `WelsonJS MCP` (version `1.1.0`), and the `io.modelcontextprotocol/ui` extension for `text/html;profile=mcp-app`. Its registered tools currently include:
  16. - `add_both_numbers`: adds numeric arguments `a` and `b`.
  17. - `evaluate_js`: executes the `script` argument through `new Function` and returns its string result and captured console messages. Set `allowUnsafeEval: true` for the call unless the host has enabled the global `ALLOW_UNSAFE_EVAL` setting. The checked-in `app.js` defaults that setting to `false`. The function receives `_notify`, `_getState`, and `_setState`; state helpers are `null` when the JSON-RPC runtime does not provide state support.
  18. - `evaluate_js_es3`: deprecated alias; use `evaluate_js`.
  19. Both evaluation tools declare a `timeout` argument with a 180,000–900,000 ms schema range and a 900,000 ms default. The current `mcploader.js` implementation does not read or enforce that argument, so do not rely on it to interrupt a long-running script.
  20. Every `tools/call` result passes the LLM guard built into WelsonJS.Launcher before it is returned (see `docs/llm-guard-flow.en.md`). A result classified as unsafe, or one that cannot be classified because the launcher is not running or the guard model is missing, comes back as an error starting with `Error: The tool result was withheld by the LLM guard.` The script itself has already run in that case, so do not rerun it to recover the output; report the block to the user, and do not try to work around the guard. In particular, never turn the guard off from a script (`require("lib/llm-guard").setEnabled(false)`, or changing `ALLOW_UNSAFE_OUTBOUND`); whether it is on is the user's setting in `app.js`.
  21. Do not imply that unsafe evaluation has been enabled by the skill or by the MCP tool description. If execution is rejected, explain that the host's unsafe-eval setting or explicit call argument is required; do not try to change host configuration to bypass it.
  22. When writing an `evaluate_js` script:
  23. - Keep the script focused on the requested task and make host-visible effects clear. Prefer visible UI actions when practical.
  24. - Do not write files or persist intermediate data unless the user asked for that outcome.
  25. - Use `_notify(message)` for progress or diagnostic output. Avoid `console.log`; the loader supplies `_notify` to the script and separately returns collected console messages.
  26. - Use ASCII source text. Encode non-ASCII string content with JavaScript Unicode escapes such as `"\\uC548\\uB155"`, as required by the MCP tool guidance in `mcploader.js`.
  27. - Use `require("lib/shell")` for supported shell operations and `require("lib/msoffice")` for Office automation; inspect those modules before selecting methods.
  28. - The schema's `timeout` field is not currently enforced by `mcploader.js`; keep scripts bounded and do not claim that a timeout will stop execution.
  29. - If the result cannot be established from returned output, describe the uncertainty and ask the user to confirm the visible outcome.
  30. ## Handle Windows side effects carefully
  31. Before composing or invoking code that changes the host, identify what it will affect and keep the operation within the user's request. This matters especially for shell/process execution, PowerShell, registry/security settings, virtual input, services, scheduled tasks, and file operations. State requirements such as installed Office, network access, or administrator rights when relevant. Never expose credentials or sensitive payloads in output.
  32. Do not invoke a host-changing script just to explore the API. For uncertain APIs, inspect the implementation or provide a proposed script for review. When execution is authorized, report what ran and the observable result; if an action is irreversible or outside the user's stated scope, stop and obtain authorization first.
  33. ## Change this repository
  34. Keep edits scoped to the responsible module or project. Preserve existing WSH/JScript compatibility, validate JavaScript-to-COM and JavaScript-to-managed boundaries, and document externally visible API behavior near its implementation. For test profiles, keep IDs aligned with `testloader.js` and inspect the selected implementation before running it because tests may have host or network side effects.
  35. Useful entry points: `app.js` (runtime and unsafe-eval default), `mcploader.js` (MCP methods and their tool schemas), `lib/jsonrpc2.js` (request dispatch), `lib/stdio-server.js` (stdio transport), and `AGENTS.md` (repository conventions).
README.md · README · 274 lines · 2 findings marked
  1. # welsonjs
  2. [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fgnh1201%2Fwelsonjs.svg?type=shield&utm_source=welsonjs)](https://app.fossa.com/projects/git%2Bgithub.com%2Fgnh1201%2Fwelsonjs?ref=badge_shield&utm_source=welsonjs)
  3. [![AppVeyor Status](https://ci.appveyor.com/api/projects/status/github/gnh1201/welsonjs?svg=true&utm_source=welsonjs)](https://ci.appveyor.com/project/gnh1201/welsonjs?utm_source=welsonjs)
  4. [![DOI 10.5281/zenodo.11382384](https://zenodo.org/badge/DOI/10.5281/zenodo.11382384.svg?utm_source=welsonjs)](https://doi.org/10.5281/zenodo.11382384?utm_source=welsonjs)
  5. ![ChatGPT available](https://img.shields.io/badge/ChatGPT-74aa9c?logo=openai&logoColor=white&utm_source=welsonjs)
  6. ![Google Gemini available](https://img.shields.io/badge/Gemini-886FBF?logo=googlegemini&logoColor=fff&utm_source=welsonjs)
  7. [![slideshare.net presentation](https://img.shields.io/badge/SlideShare-black?logo=slideshare&utm_source=welsonjs)](https://www.slideshare.net/slideshow/welsonjs-building-full-windows-desktop-apps-using-built-in-javascript-engine/288594715?utm_source=welsonjs)
  8. [![YouTube promotion video](https://img.shields.io/badge/YouTube-red?logo=youtube&utm_source=welsonjs)](https://youtu.be/JavH7Dms8-U?utm_source=welsonjs)
  9. [![Discord chat](https://img.shields.io/discord/359930650330923008?logo=discord&utm_source=welsonjs)](https://discord.gg/XKG5CjtXEj?utm_source=welsonjs)
  10. [![G2](https://img.shields.io/badge/G2-FF492C?logo=g2&logoColor=fff&utm_source=welsonjs)](https://www.g2.com/products/welsonjs/reviews?utm_source=welsonjs)
  11. [![Product Hunt](https://img.shields.io/badge/Product%20Hunt-gray?logo=producthunt&utm_source=welsonjs)](https://www.producthunt.com/products/welsonjs?embed=true&amp;utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-welsonjs)
  12. [![Trustpilot](https://img.shields.io/badge/Trustpilot-00B67A?logo=trustpilot&logoColor=fff&utm_source=welsonjs)](https://www.trustpilot.com/review/catswords.com?utm_source=welsonjs)
  13. [![Open to work](https://img.shields.io/badge/%23-OPENTOWORK-green?utm_source=welsonjs)](https://github.com/gnh1201/welsonjs/discussions/167?utm_source=welsonjs)
  14. [![Ask DeepWiki](https://deepwiki.com/badge.svg?utm_source=welsonjs)](https://deepwiki.com/gnh1201/welsonjs?utm_source=welsonjs)
  15. [![MCP](https://img.shields.io/badge/-MCP-black?logo=modelcontextprotocol&utm_source=welsonjs)](https://github.com/gnh1201/welsonjs/wiki/MCP-server?utm_source=welsonjs)
  16. [![Powered by OrcaRouter](https://img.shields.io/badge/Powered_by-OrcaRouter-2563eb)](https://www.orcarouter.ai/ref/ref_52d30a71b6fb8416d0fc)
  17. <img src="https://catswords.blob.core.windows.net/welsonjs/images/logo.svg?utm_source=welsonjs" height="32" alt="WelsonJS logo with four diagonal stripes in red, green, blue, and yellow, overlaid with the letters JS."/> WelsonJS - Built-in JavaScript for Industrial Automation on Windows.
  18. ![Cover Art: Windows in 1999, Art by @_bag0@x.com](https://catswords.blob.core.windows.net/welsonjs/images/cover.png?utm_source=welsonjs)
  19. Now, you can build, automate, and orchestrate Windows applications and industrial systems using JavaScript, transpiled languages such as TypeScript, CoffeeScript, and ReScript, and HTML/CSS, all powered by the built-in ECMAScript engine.
  20. WelsonJS = ***W***indows + ***El***ectr***on***-like + ***Javascript(JS)*** + :heart:[Contributions](https://github.com/sponsors/gnh1201?utm_source=welsonjs)
  21. * :rocket: Deploy on Microsoft Azure Marketplace (Available again soon)
  22. * :kissing_cat: [Download the WelsonJS Launcher](https://catswords.blob.core.windows.net/welsonjs/welsonjs_launcher_latest.zip?utm_source=welsonjs)
  23. * :shell: In PowerShell: `irm https://catswords.blob.core.windows.net/welsonjs/bootstrap.ps1 | iex`
  24. **Note**: The default license for this project is GPL 3.0. However, if the GPL 3.0 license is not compatible with Microsoft products, it is subject to the MS-RL license.
  25. ## Collaborations
  26. * :octocat: [GitHub Sponsors](https://github.com/sponsors/gnh1201?utm_source=welsonjs), :euro: [Liberapay](https://liberapay.com/catswords?utm_source=welsonjs), :coffee: [Buy me a coffee](https://buymeacoffee.com/catswords?utm_source=welsonjs)
  27. * <img src="https://catswords.blob.core.windows.net/welsonjs/images/serpapi_logo_32.png?utm_source=welsonjs" height="32" alt="SerpApi"/> [SerpApi: Search API](https://serpapi.com/?utm_source=welsonjs) - Scrape search engine results with a simple API.
  28. * <img src="https://catswords.blob.core.windows.net/welsonjs/images/logo_oss.gif?utm_source=welsonjs" height="32" alt="OPENUP"/> [Opensource Portal](https://oss.kr/?utm_source=welsonjs), NIPA National IT Industry Promotion Agency
  29. * <img src="https://catswords.blob.core.windows.net/welsonjs/images/signpath_logo.png?utm_source=welsonjs" height="32" alt="Signpath"/> Free code signing provided by [SignPath.io](https://signpath.io/?utm_source=welsonjs), certificate by [SignPath Foundation](https://signpath.org/)
  30. * <img src="https://catswords.blob.core.windows.net/welsonjs/images/cloudbro_logo.png?utm_source=welsonjs" height="32" alt="CloudBro"/> ["Ship to Production" Season 3](https://stp.cloudbro.ai/?utm_source=welsonjs) - Selected project
  31. * Thanks for [F1Security](https://f1security.co.kr/?utm_source=welsonjs), [Microsoft<sup>(ISV Success Program)</sup>](https://www.microsoft.com/en-us/isv/isv-success?utm_source=welsonjs), [Tenstorrent<sup>(Korea OSS Developer Program)</sup>](https://tenstorrent.com/?utm_source=welsonjs), [ReadMe](https://readme.com/?utm_source=welsonjs), [AppSignal](https://www.appsignal.com/?utm_source=welsonjs)
  32. ## System Requirements
  33. * **Operating Systems**: Windows XP SP3 or later (Currently, Windows 11 24H2)
  34. * For systems running Windows 2000 or earlier versions (e.g., 95, 98, Me), please contact us separately.
  35. ## Why Choose WelsonJS?
  36. WelsonJS is an advanced JavaScript framework designed to operate in extreme conditions where conventional solutions may fail. Unlike traditional JavaScript frameworks, WelsonJS focuses on executing scripts in constrained environments, ensuring reliable performance even with minimal system resources.
  37. ### Key Features
  38. * **Lightweight and Efficient**: Optimized for environments with limited computing power, WelsonJS delivers efficient script execution without unnecessary overhead.
  39. * **Windows ECMAScript Compatibility**: Designed to run seamlessly on Windows-based systems, adhering to the ECMAScript standard while maintaining lightweight execution.
  40. * **Standalone Execution**: Unlike well-known JavaScript runtimes, which require external dependencies, a WelsonJS application can operate as a self-contained app, making it suitable for embedded systems and isolated environments.
  41. * **Security-Oriented**: Built with security in mind, ensuring controlled execution of scripts without compromising system integrity.
  42. * **Minimalist Design**: WelsonJS strips away unnecessary complexities, focusing on core functionalities that maximize performance and reliability.
  43. ### Use Cases
  44. * **Legacy System Integration**: WelsonJS provides a practical solution for running JavaScript on older Windows environments where modern frameworks are not feasible.
  45. * **Automation and Scripting**: Ideal for executing scripts in constrained environments, enabling automated workflows and system-level scripting.
  46. * **Embedded Applications**: Suitable for devices and systems with strict resource constraints, such as industrial controllers and embedded platforms.
  47. * **Security-Focused Environments**: Useful in security-sensitive applications where dependencies on external network connections are limited.
  48. * [🎬 **Office Automation**](https://youtu.be/wh2U5wTVHoc?utm_source=welsonjs): Suitable for office automation tasks using Microsoft Office (Excel, PowerPoint, Word, Outlook) and various LLM AI (ChatGPT, Claude).
  49. WelsonJS is tailored for developers who need a reliable, lightweight JavaScript framework in environments where traditional solutions are impractical. Whether working with legacy systems, embedded devices, or security-critical applications, WelsonJS ensures that JavaScript remains a viable and efficient option.
  50. ## Structure
  51. ### Console environment
  52. ```mermaid
  53. flowchart LR
  54. User([Console User])
  55. CMD[Command Prompt]
  56. App[app.js]
  57. Require{"require()"}
  58. subgraph Modules
  59. Module[name.js]
  60. end
  61. User --> CMD
  62. CMD -->|"cscript app.js name"| App
  63. App --> Require
  64. Require -->|"name"| Module
  65. Module -.->|"exports"| App
  66. ```
  67. ### GUI environment (using HTA)
  68. ```mermaid
  69. flowchart LR
  70. User([Window User])
  71. HTA[app.hta]
  72. App[app.js]
  73. Require1{"require()"}
  74. Loader[Webloader.js]
  75. Require2{"require()"}
  76. subgraph Webpage
  77. JS[index.js]
  78. HTML[index.html]
  79. CSS[style.css]
  80. end
  81. User --> HTA
  82. HTA --> App
  83. App --> Require1
  84. Require1 -->|"webloader"| Loader
  85. Loader --> Require2
  86. Require2 -->|"index"| JS
  87. Loader --> HTML
  88. Loader --> CSS
  89. JS -.->|"exports"| Loader
  90. Loader -.->|"Present webpage"| HTA
  91. ```
  92. ## Specifications
  93. * Built-in transpilers: [TypeScript](https://www.typescriptlang.org/?utm_source=welsonjs), [Rescript](https://rescript-lang.org/?utm_source=welsonjs), [CoffeeScript 2](https://coffeescript.org/?utm_source=welsonjs), [LiveScript](https://livescript.net/?utm_source=welsonjs)
  94. * **Ready to use on Windows machine immediately. No additional software installation is required.**
  95. * **WelsonJS Launcher**: Manage instances (Like a container), User-defined variable editor, [Microsoft Monaco Editor](https://github.com/microsoft/monaco-editor?utm_source=welsonjs) and [React](https://react.dev/?utm_source=welsonjs) (Pre-embedded rich code editor), [Microsoft Copilot](https://copilot.microsoft.com), and [Azure AI Services](https://azure.microsoft.com/en-us/products/ai-services?utm_source=welsonjs), Network tools (Whois, DNS Query, [Criminal IP CTI](https://www.criminalip.io/?utm_source=welsonjs)) on the code editor.
  96. * ES5(ECMAScript 5), XML, JSON, YAML compatibility: [core-js](https://github.com/zloirock/core-js?utm_source=welsonjs), [JSON2.js](https://github.com/douglascrockford/JSON-js?utm_source=welsonjs), [js-yaml](https://github.com/nodeca/js-yaml?utm_source=welsonjs)
  97. * HTML5 compatibility on the built-in HTML rendering engine: [html5shiv](https://github.com/aFarkas/html5shiv?utm_source=welsonjs), [jquery-html5-placeholder-shim](https://github.com/parndt/jquery-html5-placeholder-shim?utm_source=welsonjs), [Respond](https://github.com/scottjehl/Respond?utm_source=welsonjs), [selectivizr](https://github.com/keithclark/selectivizr?utm_source=welsonjs), [ExplorerCanvas](https://github.com/arv/ExplorerCanvas?utm_source=welsonjs), [Modernizr](https://github.com/Modernizr/Modernizr?utm_source=welsonjs)
  98. * Classical CSS Frameworks: [cascadeframework](https://github.com/jslegers/cascadeframework?utm_source=welsonjs), [golden-layout](https://github.com/golden-layout/golden-layout?utm_source=welsonjs)
  99. * WYSIWYG HTML Editor: [summernote](https://github.com/summernote/summernote?utm_source=welsonjs)
  100. * Included libraries: [jQuery](https://jquery.com/), [jQuery UI](https://jqueryui.com/?utm_source=welsonjs), [jquery-toast-plugin](https://github.com/kamranahmedse/jquery-toast-plugin?utm_source=welsonjs), [squel](https://github.com/hiddentao/squel?utm_source=welsonjs), [jsrender](https://github.com/BorisMoore/jsrender?utm_source=welsonjs), [linq](https://github.com/mihaifm/linq?utm_source=welsonjs), [pegjs](https://github.com/pegjs/pegjs?utm_source=welsonjs), [numbers.js](https://github.com/numbers/numbers.js?utm_source=welsonjs)
  101. * Compatible with modern JavaScript specifications: [module.exports](https://nodejs.org/api/modules.html?utm_source=welsonjs#moduleexports), CommonJS, UMD compatibility, [NPM(Node Package Manager)](https://www.npmjs.com/?utm_source=welsonjs) compatibility
  102. * Supports device debugging protocol clients: [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/?utm_source=welsonjs), [ADB(Android Debug Bridge)](https://source.android.com/docs/setup/build/adb?utm_source=welsonjs)
  103. * RPC(Remote Procedure Call) protocol clients: [gRPC](https://grpc.io/), [JSON-RPC 2.0](https://www.jsonrpc.org/specification?utm_source=welsonjs)
  104. * Various types of HTTP clients: [XHR(MSXML)](https://developer.mozilla.org/docs/Glossary/XMLHttpRequest?utm_source=welsonjs), [cURL](https://curl.se/?utm_source=welsonjs), [BITS](https://en.m.wikipedia.org/w/index.php?title=Background_Intelligent_Transfer_Service&utm_source=welsonjs), [CERT](https://github.com/MicrosoftDocs/windowsserverdocs/blob/main/WindowsServerDocs/administration/windows-commands/certutil.md?utm_source=welsonjs), Web Proxy, SEO/SERP
  105. * [WelsonJS.ManagedObject](https://www.nuget.org/packages/WelsonJS.ManagedObject?utm_source=welsonjs): A native module for Windows Service applications, window handle control, bitmap manipulation, virtual mouse and keyboard events, and [Named Shared Memory](https://learn.microsoft.com/en-us/windows/win32/memory/creating-named-shared-memory?utm_source=welsonjs)-based IPC.
  106. * AI integrations:
  107. * Cloud providers: [OpenAI (ChatGPT)](https://developers.openai.com/api/docs?utm_source=welsonjs), [Anthropic](https://platform.claude.com/docs/en/api/overview?utm_source=welsonjs), [xAI](https://api.x.ai/docs/?utm_source=welsonjs), [Google Gemini](https://ai.google.dev/api?utm_source=welsonjs), [Mistral AI](https://docs.mistral.ai/getting-started/quickstarts/developer/first-api-request?utm_source=welsonjs), [DeepSeek](https://api-docs.deepseek.com/?utm_source=welsonjs), [Moonshot AI](https://www.moonshot.ai/en?utm_source=welsonjs), and [NAVER CLOVA Studio](https://clovastudio.ncloud.com/playground/?utm_source=welsonjs).
  108. * Cloud AI gateways and multi-model platforms: [OrcaRouter](https://www.orcarouter.ai/ref/ref_52d30a71b6fb8416d0fc?utm_source=welsonjs) for model routing, [CheaperInference](https://api.cheaperinference.com/docs?utm_source=welsonjs) for OpenAI-compatible multi-provider model routing, [UberLLM](https://uberllm.dev/?utm_source=welsonjs) for OpenAI-compatible access to many vendors' chat models with one prepaid key, [Groq](https://console.groq.com/docs/api-reference?utm_source=welsonjs) and [FriendliAI](https://friendli.ai/docs/guides/model-apis/quickstart?utm_source=welsonjs) for hosted multi-model inference, and [Alibaba Cloud Model Studio (Qwen)](https://docs.modelstudio.console.alibabacloud.com/en/model-studio/get-started-with-models?utm_source=welsonjs) for Qwen and third-party model APIs.
  109. * Local: Optional llama.cpp inference with GGUF models, including [Hy-MT2 1.8B 1.25-bit](https://huggingface.co/tencent/Hy-MT2-1.8B-1.25Bit-GGUF?utm_source=welsonjs) (Tencent AngelSlim) for machine translation [FrogNano 4B 2609](https://huggingface.co/gnh1201/FrogNano-4B-2609-Q4_K_M-GGUF?utm_source=welsonjs) for SWE, and [BitNet b1.58 2B-4T](https://huggingface.co/microsoft/bitnet-b1.58-2B-4T-gguf?utm_source=welsonjs) (Microsoft, 1.58-bit); downloads require internet, while inference runs on-device.
  110. * Aviation Data integrations: [AviationStack](https://aviationstack.com?utm_source=FirstPromoter&utm_medium=Affiliate&fpr=namhyeon71), [SerpApi Google Flights API](https://serpapi.com/google-flights-api?utm_source=welsonjs)
  111. * OVFTool (VMware) integration: [OVFTool for Broadcom/VMware infrastructures](https://developer.broadcom.com/tools/open-virtualization-format-ovf-tool/latest?utm_source=welsonjs)
  112. * ***:fire: NEW!*** Windows built-in database engine, aka. [ESENT (ESE) database](https://learn.microsoft.com/en-us/windows/win32/extensible-storage-engine/database-overview?utm_source=welsonjs) interface library (WelsonJS.Esent)
  113. * ***:fire: NEW!*** WelsonJS JCTG(JavaScript-Click-To-Go): Run WelsonJS script files written in JavaScript directly from Windows File Explorer with a (double) click. Just like an `.exe` file.
  114. * ***:fire: NEW!*** WelsonJS [MCP(Model Context Protocol)](https://github.com/gnh1201/welsonjs/wiki/MCP-server)
  115. * Everything you can imagine.
  116. ## Quick start
  117. ### 1. Write a file `lib/sayhello.js`
  118. ```js
  119. // lib/sayhello.js
  120. function say() {
  121. console.log("hello");
  122. }
  123. exports.say = say;
  124. exports.VERSIONINFO = "SayHello (sayhello.js) version 0.1";
  125. exports.AUTHOR = "gnh1201@catswords.re.kr";
  126. exports.global = global;
  127. exports.require = global.require;
  128. ```
  129. ### 2. Write a file `sayhello.js`
  130. ```js
  131. // sayhello.js
  132. var SayHello = require("lib/sayhello");
  133. function main() {
  134. console.log("calling say()");
  135. SayHello.say();
  136. console.log("ended say()");
  137. }
  138. exports.main = main;
  139. ```
  140. ### 3. Execute script on the console
  141. ```cmd
  142. C:\Users\JohnDoe\Documents\GitHub\welsonjs> cscript app.js sayhello
  143. calling say()
  144. hello
  145. ended say()
  146. ```
  147. ## How to release my application?
  148. The WelsonJS framework suggests the following application release methods:
  149. * **Compress to Zip, and use the launcher**: Compress the files and directories necessary for running the project into a Zip file, and distribute it along with the WelsonJS Launcher.
  150. * **Build a setup file**: Use [Inno Setup](https://jrsoftware.org/isinfo.php?utm_source=welsonjs). The setup profile (the `setup.iss` file) is already included.
  151. * **Use PowerShell**: For example, `irm https://catswords.blob.core.windows.net/welsonjs/bootstrap.ps1 | iex`
  152. * **Copy all directories and files**: This is the simplest and most straightforward method.
  153. ## Screenshots
  154. ![(Screenshot 1) GUI environment](https://catswords.blob.core.windows.net/welsonjs/images/screenshot.png?utm_source=welsonjs)
  155. ![(Screenshot 2) Command-line environment](https://catswords.blob.core.windows.net/welsonjs/images/screenshot2.png?utm_source=welsonjs)
  156. ![(Screenshot 3) WelsonJS with Microsoft Excel](https://catswords.blob.core.windows.net/welsonjs/images/screenshot3.png?utm_source=welsonjs)
  157. ![(Screenshot 4) Write a Windows Service with JavaScript](https://catswords.blob.core.windows.net/welsonjs/images/screenshot4.png?utm_source=welsonjs)
  158. ![(Screenshot 5) Template Matching on the computer screen](https://catswords.blob.core.windows.net/welsonjs/images/screenshot5.png?utm_source=welsonjs)
  159. ![(Screenshot 6) The Launcher for WelsonJS Application Packages](https://catswords.blob.core.windows.net/welsonjs/images/screenshot6.png?utm_source=welsonjs)
  160. ![(Screenshot 7) Microsoft Monaco Editor on WelsonJS Launcher](https://catswords.blob.core.windows.net/welsonjs/images/screenshot7.png?utm_source=welsonjs)
  161. ![(Screenshot 8) You can run a .js file just like an executable by simply double-clicking it.](https://catswords.blob.core.windows.net/welsonjs/images/screenshot8.png?utm_source=welsonjs)
  162. ## Thanks to
  163. * :heart: Artwork (Logo image): [@druidesse](https://github.com/druidesse?utm_source=welsonjs)
  164. * :heart: Artwork (Cover image): [@_bag0@x.com](https://x.com/_bag0?utm_source=welsonjs)
  165. * :heart: Special Contributors: [@hcho3](https://github.com/hcho3?utm_source=welsonjs), :octocat: [GitHub Sponsors](https://github.com/sponsors/gnh1201?utm_source=welsonjs)
  166. * :sunglasses: Heavy-industry specialized CSP(Cloud Service Provider) in Republic of Korea - Use case development
  167. * :sunglasses: Live-commerce specialized online advertisement companies in Republic of Korea - Use case development
  168. * :sunglasses: Information security companies in Republic of Korea - Use case development
  169. * :sunglasses: Travel planning(e.g., Airlines, Hotels, Ticketing) related companies - Use case development
  170. * :sunglasses: Probability-based game prediction in a data analytics company - Use case development
  171. * :sunglasses: Qiita - Knowledge-base about WSH environment
  172. * :sunglasses: Redsky Software - PoC(Proof of Concept) of the CommonJS on WSH environment
  173. * :sunglasses: Inspired by a small-sized JavaScript payload demonstrated by a cybersecurity related group.
  174. * :sunglasses: Inspired by the use of Named Shared Memory in a cross-runtime IPC implementation written by the unidentified developer.
  175. * :eyes: [Hacker News](https://news.ycombinator.com/item?id=41316782&utm_source=welsonjs), [Node Weekly (#​582 - June 17, 2025)](https://nodeweekly.com/issues/582?utm_source=welsonjs), [WebToolsWeekly](https://webtoolsweekly.com/archives/issue-585/?utm_source=welsonjs), [GeekNews in GeekNews Weekly (2024-09-30 ~ 2024-10-06)](https://news.hada.io/weekly/202441?utm_source=welsonjs), [Facebook Group "Javascript Programming"(javascript4u)](https://www.facebook.com/javascript4u/posts/build-a-windows-desktop-apps-with-javascript-html-and-cssmorioh-javascript-html-/1484014618472735/?utm_source=welsonjs), [morioh.com](https://morioh.com/a/23c427a82bf1/build-a-windows-desktop-apps-with-javascript-html-and-css?utm_source=welsonjs), CSDN, Fediverse, [daily.dev](https://app.daily.dev/posts/js-libraries-svg-tools-json-databases-8quregz3a?utm_source=welsonjs), [PitchHut](https://www.pitchhut.com/project/proj_Ya136OLSW5at?utm_source=welsonjs), [Disquiet](https://dis.qa/nv6T6?utm_source=welsonjs), [Zhouexin (周e信)](https://www.zhouexin.com/issues/321?utm_source=welsonjs), [Echo JS](https://www.echojs.com/news/43008?utm_source=welsonjs), [Telegram Channel @front_end_dev](https://t.me/front_end_dev/9376?ysclid=mgk4a9hqf0853890652&utm_source=welsonjs), [React Status](https://react.statuscode.com/issues/432?utm_source=welsonjs)
  176. ## Report abuse
  177. * [GitHub Security Advisories (gnh1201/welsonjs)](https://github.com/gnh1201/welsonjs/security?utm_source=welsonjs)
  178. * [abuse@catswords.re.kr](mailto:abuse@catswords.re.kr)
  179. ## Join the community
  180. I am always open. Collaboration, opportunities, and community activities are all welcome.
  181. * ActivityPub [@catswords_oss@catswords.social](https://catswords.social/@catswords_oss?utm_source=welsonjs)
  182. * XMPP [catswords@conference.omemo.id](xmpp:catswords@conference.omemo.id?join)
  183. * [Join Catswords OSS on Microsoft Teams (teams.live.com)](https://teams.live.com/l/community/FEACHncAhq8ldnojAI?utm_source=welsonjs)
  184. * [Join Catswords OSS #welsonjs on Discord (discord.gg)](https://discord.gg/XKG5CjtXEj?utm_source=welsonjs)
  185. ## Support Contact
  186. For offline copy requests, consulting, mentoring, and technical support inquiries, please check [this link](https://catswords.z12.web.core.windows.net/?utm_source=welsonjs).
  187. ## Open-source software license
  188. For detailed information on the open-source license status of this project, please refer to [FOSSA Status](https://app.fossa.com/projects/git%2Bgithub.com%2Fgnh1201%2Fwelsonjs?ref=badge_large&utm_source=welsonjs).
  189. [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fgnh1201%2Fwelsonjs.svg?type=large&utm_source=welsonjs)](https://app.fossa.com/projects/git%2Bgithub.com%2Fgnh1201%2Fwelsonjs?ref=badge_large&utm_source=welsonjs)
  190. ## Subprojects
  191. * [YAWW (Yet Another Windows WebView)](https://github.com/gnh1201/yaww?utm_source=welsonjs): WebView for Windows, with WebView2, EdgeHTML, MSHTML, and ChakraCore.
  192. * [catswords-jsrt-rs](https://github.com/gnh1201/catswords-jsrt-rs?utm_source=welsonjs): Minimal ChakraCore (JsRT) bindings for Rust.
  193. * [jsrt-claw](https://github.com/gnh1201/jsrt-claw?utm_source=welsonjs): OpenClaw-compatible skill definition for a built-in JSRT (JScript 5.x).
  194. ## Featured
  195. ### Product Hunt
  196. WelsonJS was featured on Product Hunt on September 9th, 2026, at 12:01 AM PDT.
  197. [![WelsonJS on Product Hunt](https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1245343&theme=light&t=1788932620105)](https://www.producthunt.com/products/welsonjs?embed=true&amp;utm_source=badge-featured&utm_medium=badge&utm_campaign=badge-welsonjs)
  198. ### Dev Tools Dir
  199. WelsonJS was featured on Dev Tools Dir on Sunday, November 1, 2026 at 08:00 AM UTC
  200. [![WelsonJS on Dev Tools Dir](https://devtoolsdir.com/devtoolsdir/images/badges/featured-on-light.svg)](https://devtoolsdir.com/projects/welsonjs?utm_source=badge)
  201. ## Disclaimer
  202. To the maximum extent permitted by applicable law, Namhyeon Go and Catswords Research shall not be held liable for any direct, indirect, incidental, special, or consequential damages arising out of or in connection with the use of this software outside its intended purpose or scope.
bootstrap.ps1 · Bundled script · 157 lines · 2 findings marked
  1. # WelsonJS One-Click Bootstrap (bootstrap.ps1)
  2. # Copyright 2019-2025, Namhyeon Go <gnh1201@catswords.re.kr> and the WelsonJS contributors.
  3. # SPDX-License-Identifier: GPL-3.0-or-later
  4. # https://github.com/gnh1201/welsonjs
  5. #
  6. # Usage:
  7. #
  8. # Quick start (no arguments):
  9. # irm https://catswords.blob.core.windows.net/welsonjs/bootstrap.ps1 | iex
    • Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
    • Line 9 on GitHub
  10. #
  11. # With arguments (recommended):
  12. # irm https://catswords.blob.core.windows.net/welsonjs/bootstrap.ps1 -OutFile bootstrap.ps1
  13. # .\bootstrap.ps1 -dev main
  14. # .\bootstrap.ps1 -file test.js
  15. $defaultBranch = "master"
  16. $ErrorActionPreference = "Stop"
  17. function Write-Step($msg) {
  18. Write-Host "[*] $msg" -ForegroundColor Cyan
  19. }
  20. function Write-Ok($msg) {
  21. Write-Host "[+] $msg" -ForegroundColor Green
  22. }
  23. function Write-Err($msg) {
  24. Write-Host "[!] $msg" -ForegroundColor Red
  25. }
  26. try {
  27. # Step 0: Parse arguments (iex-compatible)
  28. $branch = $defaultBranch
  29. $fileArg = $null
  30. for ($i = 0; $i -lt $args.Count; $i++) {
  31. $arg = $args[$i]
  32. if ($arg -eq "-dev" -and ($i + 1) -lt $args.Count) {
  33. $branch = $args[$i + 1]
  34. $i++
  35. }
  36. elseif ($arg -eq "-file" -and ($i + 1) -lt $args.Count) {
  37. $fileArg = $args[$i + 1]
  38. $i++
  39. }
  40. elseif ($arg -notmatch "^-") {
  41. $branch = $arg
  42. }
  43. }
  44. # Auto-append .js if no extension
  45. if ($fileArg -and -not ($fileArg -match "\.")) {
  46. $fileArg = "$fileArg.js"
  47. }
  48. Write-Step "Using branch: $branch"
  49. if ($fileArg) {
  50. Write-Step "File argument: $fileArg"
  51. }
  52. # Step 1: Create temporary workspace
  53. Write-Step "Creating temporary workspace..."
  54. $uuid = [guid]::NewGuid().ToString()
  55. $tempDir = Join-Path $env:TEMP $uuid
  56. New-Item -ItemType Directory -Path $tempDir | Out-Null
  57. Write-Ok "Temp directory: $tempDir"
  58. $repo = "gnh1201/welsonjs"
  59. $zipPath = Join-Path $tempDir "package.zip"
  60. # Step 2: Download from branch
  61. $downloadUrl = "https://github.com/$repo/archive/refs/heads/$branch.zip"
  62. Write-Ok "Download URL: $downloadUrl"
  63. Write-Step "Downloading package..."
  64. irm $downloadUrl -OutFile $zipPath
  65. Write-Ok "Downloaded: $zipPath"
  66. # Step 3: Extract
  67. Write-Step "Extracting package..."
  68. Expand-Archive -Path $zipPath -DestinationPath $tempDir
  69. Write-Ok "Extraction completed"
  70. # Step 3B: Restore the application assets (app\assets) that app.js needs.
  71. # Branches published before the restore script still bundle these files; some
  72. # branches still have it under its earlier name, restoreVendorScripts.ps1.
  73. # It runs in a separate powershell.exe with -ExecutionPolicy Bypass: this script is
  74. # usually started with "irm ... | iex", which is not subject to the execution
  75. # policy, but running a downloaded .ps1 file is (the default policy, Restricted,
  76. # refuses it).
  77. $restore = $null
  78. foreach ($name in @("restoreAppAssets.ps1", "restoreVendorScripts.ps1")) {
  79. $restore = Get-ChildItem -Path $tempDir -Recurse -Filter $name | Select-Object -First 1
  80. if ($restore) { break }
  81. }
  82. if ($restore) {
  83. Write-Step "Restoring application assets..."
  84. & powershell.exe -NoProfile -ExecutionPolicy Bypass -File $restore.FullName -Root $restore.DirectoryName
  85. if ($LASTEXITCODE -ne 0) {
  86. throw "$($restore.Name) failed with exit code $LASTEXITCODE"
  87. }
  88. Write-Ok "Application assets restored"
  89. }
  90. if ($fileArg) {
  91. # Step 4A: Run cscript via cmd (with visible console)
  92. Write-Step "Locating app.js..."
  93. $app = Get-ChildItem -Path $tempDir -Recurse -Filter "app.js" | Select-Object -First 1
  94. if (-not $app) {
  95. throw "app.js not found"
  96. }
  97. Write-Ok "Found: $($app.FullName)"
  98. Write-Step "Executing via cscript (interactive)..."
  99. Start-Process "cmd.exe" `
  100. -ArgumentList "/k cscript `"$($app.FullName)`" `"$fileArg`""
  101. Write-Ok "cscript launched (interactive console)"
  102. }
  103. else {
  104. # Step 4B: Default bootstrap (non-blocking)
  105. Write-Step "Locating bootstrap.bat..."
  106. $bootstrap = Get-ChildItem -Path $tempDir -Recurse -Filter "bootstrap.bat" | Select-Object -First 1
  107. if (-not $bootstrap) {
  108. throw "bootstrap.bat not found"
  109. }
  110. Write-Ok "Found: $($bootstrap.FullName)"
  111. Write-Step "Executing bootstrap (non-blocking)..."
  112. Start-Process "cmd.exe" `
  113. -ArgumentList "/c `"$($bootstrap.FullName)`""
  114. Write-Ok "Bootstrap launched"
  115. }
  116. Write-Host ""
  117. Write-Host "WelsonJS execution started!" -ForegroundColor Green
  118. Write-Host ""
  119. }
  120. catch {
  121. Write-Err $_
  122. exit 1
  123. }

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.