# capsulatedev/capsulate

Source: https://glimind.com/server/github%2Fcapsulatedev%2Fcapsulate
Registry id: `github/capsulatedev/capsulate`
Status: unknown

## Tools (54)

- `capsulate_browser_click`: Click an element of the page by ref (from capsulate_browser_snapshot), CSS selector or visible text.
- `capsulate_browser_eval`: Evaluate a JavaScript expression in the page and return its JSON value (awaits promises). For reading data the outline does not show.
- `capsulate_browser_fill`: Type a value into a field (replacing what is there); submit presses Enter after. Never use it for passwords or card numbers: hand the screen to the person inste
- `capsulate_browser_navigate`: Load a url in the browser's current tab and wait for it.
- `capsulate_browser_open`: Open the agent's own Chrome on a desktop capsule (the person watching sees it) and optionally load a url. For web pages prefer the capsulate_browser_* tools: th
- `capsulate_browser_press`: Press keys in the page, in order: 'Enter', 'Tab', 'Escape', 'ArrowDown', 'PageDown' or a single character.
- `capsulate_browser_screenshot`: A screenshot of the browser page only (fast, small JPEG). For the whole desktop use capsulate_screenshot.
- `capsulate_browser_scroll`: Scroll the page by dy pixels (negative scrolls up), or bring an element into view by ref, selector or text.
- `capsulate_browser_select`: Choose an option of a dropdown (<select>) by its value or label.
- `capsulate_browser_snapshot`: Read the current page as an outline of elements with refs, e.g. [e12] link "Pricing". Act on them by ref with the other browser tools. Refs stay valid until the
- `capsulate_browser_tabs`: List the browser's tabs, or open (new, with url), switch to (select) or close one (by tab id).
- `capsulate_browser_text`: The page's visible text, or one element's (by ref, selector or text).
- `capsulate_browser_wait`: Wait until an element or text appears (or, with state 'hidden', goes away). Without a target, waits for the page to finish loading.
- `capsulate_catalog`: List the operating systems / base templates and marketplace bundles you can launch.
- `capsulate_click`: Click at pixel (x, y) in a desktop capsule. Pass screenshot:true to see the screen after the click.
- `capsulate_click_element`: Find an accessible element (waiting for it if needed) and click its center. The reliable way to press a named button or link.
- `capsulate_clipboard`: Without `text`, return the desktop capsule's clipboard. With `text`, put that text on the clipboard (then paste with ctrl+v). Pasting long text is faster and sa
- `capsulate_console_link`: Mint a signed, expiring URL that opens the desktop capsule's LIVE screen in any browser with no login. The person watching sees your pointer, clicks and keys as
- `capsulate_control`
- `capsulate_destroy`: Terminate a capsule and release its resources.
- `capsulate_drag`
- `capsulate_element`
- `capsulate_exec`
- `capsulate_find_element`: Find accessible elements by role / name / text in a desktop capsule. Each match has a center (cx, cy) to click.
- `capsulate_get`: Fetch a capsule's full details by id.
- `capsulate_handoff`: Hand the desktop capsule's screen to the person watching, with a note saying exactly what you need (sign in, solve a CAPTCHA, approve a payment, check something
- `capsulate_inbox`: The team's inbox: runs that ask a question or are stuck on a step, versions waiting for approval, versions whose rehearsal failed, and skills whose software cha
- `capsulate_key`: Press keys in a desktop capsule, in order. Each entry is one key or a '+'-joined chord (xdotool names): ['ctrl+c'] copies, ['ctrl+l', 'Return'] focuses then sub
- `capsulate_launch`: Launch a new isolated cloud sandbox (capsule) and (by default) wait until it is ready. Returns the capsule id and connection info. Use the returned sessionId fo
- `capsulate_lesson`
- `capsulate_list`: List the team's active capsules.
- `capsulate_menus`: List every menu of the focused window (or the window whose title contains window) with its items, read by opening each menu and closing it again. The quick way 
- `capsulate_move`: Move the mouse pointer of a desktop capsule to (x, y) in screen pixels.
- `capsulate_ocr`: OCR the desktop capsule's screen (or a region) and return the words with their boxes. Use when the UI tree has no labels (canvas apps, images).
- `capsulate_open`
- `capsulate_read_file`: Read a UTF-8 text file from inside a capsule. One call, no screen needed.
- `capsulate_run_actions`
- `capsulate_run_code`: Run a snippet of code inside a capsule: python, node or bash on Linux, powershell on Windows (about 0.3 s). Returns stdout/stderr/exit. Faster than doing the sa
- `capsulate_say`: Show one short line on the live console of a desktop capsule, e.g. 'Opening the settings to change the theme'. Narrate each step so the person watching knows wh
- `capsulate_screen_info`: The screen's size in pixels, the pointer's position and the active window of a desktop capsule. Use it instead of a screenshot when that is all you need.
- `capsulate_screenshot`: Capture a screenshot of a desktop capsule. Returns the image so you can see the screen. For a smaller, faster image ask for format 'jpeg', a scale such as 0.5, 
- `capsulate_scroll`: Scroll at (x, y) in a desktop capsule. dy > 0 scrolls down, dy < 0 up; dx scrolls sideways. Units are wheel clicks.
- `capsulate_set_env`: Set environment variables inside a running capsule.
- `capsulate_skill_run`
- `capsulate_skills`
- `capsulate_snapshot`: Capture a snapshot of a capsule's current state (restorable later).
- `capsulate_type`: Type text into the focused field of a desktop capsule.
- `capsulate_ui_tree`: Return the accessibility tree of a desktop capsule (AT-SPI on Linux, UI Automation on Windows): roles, names, values, states and screen rectangles with centers 
- `capsulate_wait_element`: Wait until an accessible element matching the selector appears (for example after a page load).
- `capsulate_wait_for`
- `capsulate_wait_for_handback`: Wait until the person holding the desktop capsule's screen hands it back. Returns at once when nobody holds it. Returns their note.
- `capsulate_window`: Minimize, maximize, restore, close, move, resize or focus a window of a desktop capsule, by id (from capsulate_windows) or a part of its title. move takes x, y 
- `capsulate_windows`: Without a target, list the open windows of a desktop capsule. With `id` or `title`, bring that window to the front. To minimize, maximize, move, resize or close
- `capsulate_write_file`: Write a UTF-8 text file inside a capsule (the folder is created). One call, far faster than typing it into an editor on the screen; open it afterwards with caps

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
