terminal-mac — скилл для Claude Code: что делает и как установить
Скилл terminal-mac для Claude Code управляет отдельной виртуальной macOS через снимки экрана, клики и ввод текста. Запускает задачи в графическом интерфейсе Mac, не затрагивая рабочий стол пользователя.
MIT ★ 2 917 обновлён 2026-11-10
/plugin marketplace add govijr/terminal-mac
/plugin install terminal-mac@terminal-macЧто делает terminal-mac
terminal-mac управляет виртуальной машиной macOS: делает снимки экрана и отправляет клики, нажатия клавиш и текст. Действия проходят внутри гостевой системы, отдельно от рабочего стола пользователя. Так можно проверять Mac-приложения или работать с сайтами и программами через графический интерфейс.
Для управления подойдут MCP-инструменты или CLI terminal-mac; команды CLI возвращают JSON. Виртуальная машина работает на Apple silicon. Если её ещё нет, terminal-mac up NAME скачивает macOS с серверов Apple, а первичную настройку выполняет пользователь. При запросе пароля, кода двухфакторной аутентификации или разрешения macOS агент должен остановиться и запросить пользователя.
Какие задачи решает
- проверить Mac-приложение в графическом интерфейсе
- открыть сайт и выполнить действия в браузере виртуальной macOS
- вводить текст и использовать сочетания клавиш в отдельной системе
- изолировать компьютерные задачи от рабочего стола пользователя
Примеры запросов агенту
- Проверь, открывается ли приложение в виртуальной macOS, и сделай снимок экрана.
- Открой Safari в виртуальной машине и проверь эту страницу.
- Введи текст в окно приложения через виртуальную macOS, не трогая мой рабочий стол.
Как установить terminal-mac
1Через маркетплейс плагинов
/plugin marketplace add govijr/terminal-mac/plugin install terminal-mac@terminal-macКоманда ставит плагин terminal-mac целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add govijr/terminal-mac --skill terminal-mac -a claude-code3Вручную: положить файлы
~/.claude/skills/terminal-mac/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/terminal-mac/
1Через Skills CLI (Vercel)
npx skills add govijr/terminal-mac --skill terminal-mac -a codex2Вручную: положить файлы
.agents/skills/terminal-mac/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add govijr/terminal-mac --skill terminal-mac -a cursor2Вручную: положить файлы
.cursor/skills/terminal-mac/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install govijr/terminal-mac skills/terminal-mac2Вручную: положить файлы
.github/skills/terminal-mac/SKILL.md1Через Skills CLI (Vercel)
npx skills add govijr/terminal-mac --skill terminal-mac -a gemini-cli2Командой платформы
gemini skills install https://github.com/govijr/terminal-mac --path skills/terminal-macВручную: положить файлы
.devin/skills/terminal-mac/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о terminal-mac
Как установить terminal-mac в Claude Code?
Для установки через маркетплейс выполни по порядку: /plugin marketplace add govijr/terminal-mac, затем /plugin install terminal-mac@terminal-mac.
Что делает terminal-mac?
Он управляет отдельной виртуальной macOS через снимки экрана, клики, ввод текста и клавиатурные команды. Действия не затрагивают рабочий стол пользователя.
Что нужно для работы terminal-mac?
Нужна виртуальная macOS на Apple silicon. Если виртуальной машины ещё нет, terminal-mac up NAME скачивает macOS с серверов Apple и запускает первичную настройку.
Исходный текст
SKILL.md · MIT
--- name: terminal-mac description: Operate a separate virtual Mac (macOS VM) with screenshots, clicks, typing and shortcuts, without touching the user's own desktop. Use when a task needs a real macOS GUI — testing a Mac app, using a website or desktop app, or any computer-use task the user wants sandboxed. --- # terminal-mac `terminal-mac` runs a real macOS guest on Apple silicon. A helper inside the guest captures its screen and posts input, so everything you do happens in the VM. It never controls the user's own desktop. ## Prefer the MCP tools If tools named `screenshot`, `click`, `type`, `key` and so on from the `terminal-mac` MCP server are available, use them: 1. `status`: the VM is running and both guest permissions are `true`. 2. `screenshot`: every x/y you pass to other tools is a pixel in this image (top-left origin). 3. Act with `click` (`clicks: 2` double-clicks, `button: "right"`), `move`, `drag`, `scroll` (negative `dy` scrolls down), `type` (literal text) or `key` (`return`, `tab`, `escape`, `cmd+space`, `cmd+c`, `cmd+shift+4`…). 4. Look again: pass `screenshot: true` to an action, or call `screenshot`, before deciding the next step. Opening an app: `key cmd+space`, `type "Safari"`, `key return`. Prefer keyboard shortcuts over hunting for small targets. ## Without MCP: the CLI Every command prints JSON and exits nonzero on failure. `NAME` defaults to `default`. ```bash terminal-mac status NAME # stopped → terminal-mac start NAME terminal-mac action NAME status terminal-mac action NAME screenshot --output /tmp/guest.png # then view the PNG terminal-mac action NAME click X Y [--double] [--button right] terminal-mac action NAME move X Y terminal-mac action NAME drag X Y X2 Y2 terminal-mac action NAME type 'literal text' terminal-mac action NAME key cmd+space terminal-mac action NAME scroll --dy -300 --x X --y Y ``` Text is sent as Unicode keyboard events, not through the clipboard. No shell-execution action exists. ## When to stop and ask the user - The guest is at its login screen, or the helper is not running (tools report "no logged-in session"): ask the user to sign in, for example `terminal-mac view NAME` then Ctrl+O. Automatic login in the guest avoids this on later boots. - A macOS permission prompt, password, two-factor code or payment appears in the guest. - The VM does not exist: `terminal-mac up NAME` downloads macOS from Apple (several GB) and needs the user for first-time setup. ## Safety - Do not run `terminal-mac guest` on the host, and never fall back to host screenshots or host input tools. - Apps, files and accounts inside the VM are separate from the user's Mac. Do not move secrets into it unless the user asks. - `stop` requests shutdown; `stop --force` can lose guest work, so use it only when a normal shutdown cannot complete.
© Govijr · MIT · govijr/terminal-mac