К основному содержанию
скилл CX Codex

terminal-mac — скилл для Claude Code: что делает и как установить

Скилл terminal-mac для Claude Code управляет отдельной виртуальной macOS через снимки экрана, клики и ввод текста. Запускает задачи в графическом интерфейсе Mac, не затрагивая рабочий стол пользователя.

MIT ★ 2 917 обновлён 2026-11-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add govijr/terminal-mac
/plugin install terminal-mac@terminal-mac
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/terminal-mac/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/terminal-mac/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Каталог скиллов SKILL.md →
things-mac openclaw Скилл things-mac управляет задачами Things 3 на macOS: помогает просматривать списки и искать задачи, а также добавлять и обновлять записи. CX Codex +1 5 200установок new-mac-app daveebbelaar Скилл new-mac-app для Claude Code создаёт нативное macOS-приложение на SwiftUI из готового шаблона. Он запускается, когда нужен новый проект или каркас приложения. CX Codex +1 1 000установок test-mac-app daveebbelaar Скилл test-mac-app для Claude Code помогает проверять macOS-приложение на нескольких уровнях — от Swift-тестов до управления запущенной программой. Активируется при добавлении логики, исправлении ошибок и проверке перед релизом. CX Codex +1 1 000установок mac-code-local-ai-agent reason-machines Скилл mac-code-local-ai-agent поднимает локальный ИИ-агент для кодинга на Apple Silicon: модель крутится на вашем Mac, без облака и подписки. CX Codex +1 851установок openclaw-local-mac-mini devops-skills Скилл openclaw-local-mac-mini для Claude Code помогает развернуть OpenClaw локально и настроить Mac mini для постоянной работы агента. Включается при настройке Docker Compose, сети и служб macOS. CX Codex +1 346установок mac-mini-llm-lab devops-skills Скилл mac-mini-llm-lab готовит Mac mini на Apple Silicon к роли автономного сервера нейросетей: настраивает Ollama, MLX, автозапуск через launchd и удалённый доступ. CX Codex +1 344установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой