clipaste CLI
Скриншот из буфера доходит до Claude Code, Codex и Cursor на macOS, Windows, по SSH и в WSL2, без настройки
- 65 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Служба читает буфер обмена и открывает его картинки по HTTP на локальном порту, а по SSH-туннелю их получает удаленный сервер
- На macOS и Windows она меняет содержимое буфера, добавляя путь к файлу рядом с изображением
Установка
- Работает в
Ручная установка
brew install hqhq1025/clipaste/clipasteЗатем `brew services start clipaste`. Windows: однострочник `install.ps1`; любая платформа: `cargo install --git https://github.com/hqhq1025/clipaste --tag v2.6.0 --locked`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Служба читает буфер обмена и открывает его картинки по HTTP на локальном порту, а по SSH-туннелю их получает удаленный сервер
- На macOS и Windows она меняет содержимое буфера, добавляя путь к файлу рядом с изображением
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
clipaste — небольшая фоновая служба на Rust, которая чинит вставку скриншотов в терминальных ИИ-инструментах вроде Claude Code, Codex CLI и Cursor. На macOS скриншот кладет в буфер только сырые данные TIFF или PNG, а терминалы Ghostty и Alacritty умеют вставлять через Cmd+V лишь текст и ссылки на файлы. clipaste сохраняет скриншот как PNG, добавляет путь рядом с изображением и включает Cmd+V, а для Ctrl+V добавляет старый тип PNGf. По SSH служба запускает HTTP-сервер на `localhost:18340`. Команда `clipaste ssh-setup user@your-server` настраивает удаленную машину: определяет ее ОС, ставит оболочку xclip или wl-paste в `~/.local/bin/` и туннель SSH, так что Ctrl+V в удаленном Claude Code забирает картинку с вашего локального буфера. На сервере нужен только `curl`. Для WSL2 та же оболочка смотрит прямо на `clipaste.exe` в Windows, туннель не нужен. Локальная служба работает на macOS и Windows, а на Linux с графической сессией только отдает PNG из буфера по SSH, не меняя его. Режим «только сервер» оставляет буфер macOS и Windows нетронутым, если вставляете только в удаленные агенты.
Для кого. Тем, кто работает с Claude Code или Codex в терминале на macOS, по SSH на сервере или в WSL2 и не может вставить в него скриншот.
Подходит, если
- После скриншота Cmd+V или Ctrl+V в Claude Code ничего не вставляет в терминале Ghostty
- Агент запущен на удаленном сервере по SSH, а картинка лежит в локальном буфере
- Claude Code живет в WSL2, а скриншот сделан в Windows
- Нужен режим «только сервер»: картинки уходят удаленным агентам, локальный буфер остается без изменений
Не подходит, если
- Вам нужен менеджер буфера обмена или синхронизация между устройствами: clipaste передает только картинки в агентов
- На Linux нет графической сессии с рабочим буфером: хостинг возможен только в такой сессии
- Агент не ходит в `localhost:18340` и не может использовать оболочку xclip
Пример запроса к агенту
Сделал скриншот ошибки. Вставь его из буфера обмена и скажи, что на нем написаноОграничения
- Хостинг буфера возможен на macOS, Windows и Linux с графической сессией и рабочим буфером; на Linux он только читает и отдает `image/png`, совместимость с оболочкой рабочего стола надо проверить на месте.
- Удаленному серверу нужен `curl`, а для Linux на хосте ставят `wl-clipboard` и `xclip`; службы автозапуска на Linux установка не создает.
- На macOS и Windows служба меняет локальный буфер, добавляя путь рядом с изображением; чтобы этого избежать, включают режим «только сервер».
- HTTP-сервер на `localhost:18340` отдает картинки из буфера: держите туннель на доверенных серверах.
Как отключить. Службу останавливают `brew services stop clipaste` на macOS, пакет убирают `brew uninstall clipaste`; оболочку на сервере удаляют из `~/.local/bin/`.
Частые вопросы
Как поставить clipaste на macOS?
Выполните `brew install hqhq1025/clipaste/clipaste` и запустите службу командой `brew services start clipaste`. Для Windows есть однострочник `install.ps1`, а на любой платформе можно собрать через `cargo install --git https://github.com/hqhq1025/clipaste --tag v2.6.0 --locked`.
Как включить вставку по SSH?
Запустите службу локально и выполните `clipaste ssh-setup user@your-server`. Для нестандартного порта добавьте `-p 22222`. Команда сама определит ОС сервера и поставит оболочку.
Работает ли clipaste в WSL2?
Да, если `clipaste.exe` запущен на стороне Windows: оболочка xclip в WSL2 подключается к нему напрямую без SSH-туннеля.
Почему Ctrl+V не вставляет скриншот в терминале?
Скриншот macOS кладет в буфер сырые данные TIFF или PNG, а терминалы вставляют только текст и ссылки на файлы. clipaste добавляет рядом путь к PNG, и вставка начинает работать.
Сколько ресурсов занимает служба?
По описанию автора, около 9 МБ памяти и почти 0 процентов процессора в простое, без настроек.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер Clippy для macOS: агент кладет текст, файлы и письма в буфер обмена, чтобы вставить в Slack, Gmail или Teams.
Плагин Claude Code для вставленных картинок: миниатюры над строкой ввода и редактор с пометками перед отправкой.
Синхронизация буфера обмена между устройствами с встроенным MCP-сервером: агент читает вашу историю копирования, данные не уходят в облако
Именованные буферы обмена сохраняют текст и файлы из терминала, чтобы переносить результаты между командами и сеансами.
Приложение для macOS помнит, что было на экране, и открывает агентам историю по MCP: поиск, дни, потоки работы, скриншоты.
Скилл и MCP для записи экрана с голосом: агент превращает рассказ о баге в задачи со скриншотами, шагами и вероятным кодом
Коротко о README
README объясняет проблему вставки скриншотов в терминальные ИИ-инструменты, причину и решение, перечисляет платформы, способы установки и настройку SSH и WSL2 и режим «только сервер».