Using Simulang with Claude Code

Simulang is a Claude Code skill for desktop automation on macOS. You describe the task in natural language (open apps, click controls, type text, scroll, capture screenshots, inspect the accessibility tree); Claude looks up the installed simulang-js API, writes a TypeScript script, and runs it with the Simulang CLI—same building blocks as the Simulang Primer.

Setup

Install simulang CLI globally:
npm install -g @simular-ai/simulang
Install the Claude Code skill:
simulang init-claude
(Optional) Enable the log viewer for visual debugging:
npm install @simular-ai/simulang-log-viewer
Then tell Claude: /simulang enable log view in all scripts

Usage

Invoke the skill with /simulang followed by what you want to do:

/simulang open google and search for weather in sf
/simulang take a screenshot of the current screen
/simulang find all buttons on the screen using accessibility tree
/simulang click on the submit button
/simulang type "hello world" and press enter

Claude will:

Look up the simulang-js API docs for the installed version
Write a TypeScript script
Run it with simulang run
Show you screenshots or results

Example Prompts

Prompt	What Claude Does
`/simulang open safari and go to github.com`	Opens browser, navigates to URL
`/simulang search for "Simular" on this page`	Presses Cmd+F, types search term
`/simulang scroll down and take a screenshot`	Scrolls, captures screen
`/simulang what's the version of simulang?`	Runs `simulang --version`
`/simulang read the simulang-js API docs`	Reads `index.d.ts` and `CLAUDE.md`

Tips

Be specific — “click the blue Submit button” works better than “click submit”
Ask for screenshots — Claude can capture and view what’s on screen
Use grounding models — For visual element finding, set OPENROUTER_API_KEY
Enable log viewer — Helps when the terminal is hidden behind automated apps

Requirements

Node.js >= 22.18
macOS: Grant Accessibility and Screen Recording permissions when prompted

Getting Started

Simulang

Simular

Agent S

Simulang with Claude Code

Using Simulang with Claude Code

Setup

Usage

Example Prompts

Tips

Requirements

​Using Simulang with Claude Code

​Setup

​Usage

​Example Prompts

​Tips

​Requirements

Using Simulang with Claude Code

Setup

Usage

Example Prompts

Tips

Requirements