Simulang
Automate desktop tasks using Simulang, a JavaScript-based DSL for Simular Pro. Use when the user asks about desktop automation, UI scripting, controlling applications, keyboard/mouse automation, or writing Simular Pro scripts.From its SKILL.md
npx -y skills add simular-ai/simulang-plugin --skill simulangAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.8 KB, as published. Nobody here has run it
Simulang (Simular Pro Action Language)
Simulang is a JavaScript-based DSL for Simular Pro that controls desktop environments through natural language-like functions for keyboard, mouse, perception, and application control.
Quick Reference
| Category | Key Functions |
|---|---|
| Application | open({app, url}) |
| Keyboard | type({text, withReturn}), press({key, cmd, ctrl, shift}) |
| Mouse | click({at, mode, spatialRelation}), scroll({direction}) |
| Perception | pageContent(), ask({prompt, context}), conceptsExist({concepts}) |
| Wait | wait({waitTime}), waitForConcepts({concepts}) |
| User | respond({message, requireConfirm}) |
| Files | readFile({path}), writeToFile({text, path}) |
| Google Sheets | getGoogleSheetCellValue({cell}), setGoogleSheetCellValue({cell, value}) |
| Background Browser | browser.newtab(url), page.click(), page.type(), page.content(), page.ask() |
Click Modes
// Default: text-based grounding
click({at: "sign in button"})
// Vision: for images/icons without text labels
click({at: "logo icon", mode: "vision"})
// Text + Screenshot: combines both methods
click({at: "Introduction in Simular Browser section", mode: "textAndScreenshot"})
// Spatial relation: disambiguate similar elements
click({at: "close button", spatialRelation: "containedIn", anchorConcept: "dialog"})
Spatial options: closest, furthest, above, below, left, right, contains, containedIn
Common Pattern: Extract & Process
function main() {
open({url: "https://example.com"});
wait({waitTime: 3});
var content = pageContent();
var result = ask({
prompt: "Extract all items. Return as JSON array.",
context: content
});
return JSON.parse(result);
}
Background Browser Control
For web automation tasks that can run in parallel without GUI focus, use the background browser API:
async function main() {
// Open multiple pages in parallel
const pages = await Promise.all([
browser.newtab("https://news.google.com/"),
browser.newtab("https://www.bbc.com/news")
]);
// Wait for pages to load
await Promise.all(pages.map(p => p.wait({ waitTime: 2 })));
// Get content from all pages
const contents = await Promise.all(pages.map(p => p.content()));
// Summarize with LLM
const summary = await pages[0].ask({
prompt: "Summarize the key headlines",
context: { text: contents.join("\n\n") }
});
console.log(summary);
}
Key Differences from Desktop Mode:
- Use
browser.newtab(url)instead ofopen({url}) - All actions are async (
awaitrequired) - Pages run independently in parallel
- Use
page.ask()withcontext: {text: ...}format
Best Practices
- Wait for loads: Use
wait({waitTime: 2-3})after navigation - Be specific: Use role+value in descriptions ("sign in button" not "button")
- Use
ask()for extraction: Pair withpageContent()for structured data - Handle errors: Use
respond({message, requireConfirm: true})for confirmations - Parallelize when possible: Open multiple browser tabs concurrently for faster results
- Minimize clicks: Use URLs with parameters to navigate directly when possible
Resources
- reference.md - Complete API documentation
- examples.md - Practical workflow examples
- Official docs