dwmkerr/shellwright

🖥️ 谢尔赖特 剧作家为壳体。AI驱动的终端自动化、截图和视频录制。 终于。你的AI代理可以关闭Vim

用户：打开Vim。告诉我怎么关闭它。关闭它。把它录成视频。

快速入门 | 示例 | 安装 | 配置 | MCP工具 | 开发者指南

快速开始

配置你的大型语言模型、Claude代码、光标或其他工具来使用Shellwright MCP服务器：

使用如下提示：

使用 shellwright，打开 Vim。写一条消息说明如何关闭 Vim。关闭 Vim。给我每个步骤的截图和 GIF 录制，截图和视频保存到 ‘./output’ 中。

视频录制会被保存，同时还会有多种格式的截图。

详情请查看示例或安装指南。我也用它为我的书《Effective Shell》制作丰富的录音。

本地运行

在本地开发时，以HTTP模式运行MCP服务器：

服务器运行在http://localhost:7498/mcp。

与MCP检查员测试

在另一个终端打开MCP检查器，连接到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