> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simular.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Simulang with Claude Code

> Automate your Mac from Claude Code with the /simulang skill—install, prompts, and desktop tips.

# 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](/simulang/simulang-primer).

## Setup

1. **Install simulang CLI globally:**
   ```bash theme={null}
   npm install -g @simular-ai/simulang
   ```

2. **Install the Claude Code skill:**
   ```bash theme={null}
   simulang init-claude
   ```

3. **(Optional) Enable the log viewer** for visual debugging:
   ```bash theme={null}
   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:

1. Look up the simulang-js API docs for the installed version
2. Write a TypeScript script
3. Run it with `simulang run`
4. 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