simulang

Run Simulang scripts with pinned simulang-js versions via CLI.

101|4|Updated May 15, 2026
One-click install
npx skills add https://github.com/simular-ai/simulang --skill simulang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: simulang
Source: https://github.com/simular-ai/simulang/tree/main
Command: npx skills add https://github.com/simular-ai/simulang --skill simulang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simulang provides a CLI to run TypeScript or JavaScript scripts that leverage the @simular-ai/simulang-js desktop automation library. It bundles its own simulang-js but lets each script pin a specific version to ensure deterministic toolchains across projects and environments.

Core Features & Use Cases

  • Run scripts with simulang run <script>, and pin a specific simulang-js version with --simulang-js or the SIMULANG_JS environment variable.
  • Open an interactive Node REPL pre-loaded with all simulang-js exports for rapid experimentation, or use simulang which to inspect a script's resolved runtime.
  • Manage Claude Code integration (installable skill), guide Claude on how to use simulang and simulang-js, and perform project- or user-local installs.
  • Ensure cross-platform correctness by supporting setup and permission hints, so you can reliably run automation scripts on macOS, Windows, and Linux.

Quick Start

Install the CLI and run a sample script with simulang run hello.ts.

Frequently Asked Questions about simulang

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I pin a specific version of a JavaScript library for running TypeScript automation scripts?

Run simulang scripts with precise versioning by orchestrating the CLI, Node runtime, and simulang-js bindings. It supports per-script version pinning via the --simulang-js flag or the SIMULANG_JS environment variable to ensure deterministic toolchains.

Does the simulang CLI require a specific Node version to run desktop automation scripts?

Yes, running simulang scripts requires Node 22.18 or higher. The CLI orchestrates the Node runtime and simulang-js bindings, handling overrides and caching to ensure cross-platform correctness on macOS, Windows, and Linux.

How do I install Claude Code integration for a JavaScript automation project locally?

Install Claude Code integration for a JavaScript automation project locally by using the CLI's install command. It supports both project- and user-local installs, guiding Claude on how to use simulang and simulang-js bindings.

Can I open an interactive Node REPL pre-loaded with desktop automation exports?

Yes, you can open an interactive Node REPL pre-loaded with all simulang-js exports for rapid experimentation. The CLI also provides a which command to inspect a script's resolved runtime and path resolution.

Why does running a simulang script fail with a version mismatch across different environments?

Running a simulang script fails with a version mismatch when the bundled simulang-js differs from the environment's version. Pin a specific simulang-js version with --simulang-js or the SIMULANG_JS environment variable to ensure deterministic toolchains.