dwmkerr/shellwright

️ shellwright Драматург для раковины. Автоматизация терминалов на основе ИИ, скриншоты и видеозапись. Наконец-то. Агенты ИИ могут закрыть Vim

Пользователь: Open Vim. Скажи мне, как его закрыть. Закрой его. Запишите это как видео.

Быстрый старт Примеры | Установка | Конфигурация | MCP Инструменты Руководство для разработчиков

##Быстрый старт

Настройте LLM, код Клода, курсор или что-либо еще, чтобы использовать MCP-сервер Shellwright:

Используйте подсказку, такую как:

Использование shellwright, open Vim. Напиши сообщение о том, как закрыть Вим. Дайте мне скриншот каждого шага и запись GIF, сохраните скриншоты и видео на ‘./output’.

Будет сохранена видеозапись, а также скриншоты в нескольких форматах.

Проверьте примеры или руководство по установке для более подробной информации. Я также использую это для создания богатых записей для моей книги «Эффективная доска».

Бег локально

Запустите MCP-сервер в HTTP-режиме для локальной разработки:

Сервер работает на http://localhost:7498/mcp.

Тестирование с инспектором MCP**

Откройте MCP Inspector в другом терминале и подключитесь к http://localhost:7498/mcp, чтобы перечислить и протестировать инструменты:

Тестирование с агентом **

Запустите демонстрацию.

🖥️ shellwright Playwright for the shell. AI-driven terminal automation, screenshots and video recording. Finally. Your AI agents can close Vim

User: Open Vim. Tell me how to close it. Close it. Record this as a video.





Quickstart |
Examples |
Installation |
Configuration |
MCP Tools |
Developer Guide

Quickstart

Configure your LLM, Claude Code, Cursor or whatever to use the Shellwright MCP server:

{
  "mcpServers": {
    "shellwright": {
      "command": "npx",
      "args": ["-y", "@dwmkerr/shellwright"]
    }
  }
}

Use a prompt such as:

Using shellwright, open Vim. Write a message saying how to close Vim. Close Vim. Give me a screenshot of each step and a GIF recording, save the screenshots and videos to ‘./output’".

A video recording will be saved, as well as screenshots in multiple formats.

Check the Examples or Installation guide for more details. I also use this to create rich recordings for my book Effective Shell.

Running Locally

Run the MCP server in HTTP mode for local development:

npm install
npm run dev:http

# Or add parameters if needed...
npm run dev:http -- --font-size 32

The server runs at http://localhost:7498/mcp.

Testing with the MCP Inspector