plainhub

Name: plainhub
Author: ricrio-inc

本地服务

github.com/ricrio-inc生产力21 天前更新

代码仓库

关于 plainhub

PlainHub 是面向 Claude Code 用户的 GitHub 编辑器和审批界面，可编辑仓库文件、审阅 Agent 进度与决策卡片，并将 AI 面板连接到用户自己的 Claude Code。

主要功能

01在浏览器中编辑 GitHub 文件
02Markdown 代码、可视化和预览模式
03审阅 Agent 进度和决策卡片
04查看文件历史及差异
05跨仓库搜索

适用场景

01通过手机编辑并提交仓库文件
02远程批准或拒绝 Agent 决策
03查看文件旧版本及变更

MCP 相关

PlainHub 提供 MCP 服务，供 Claude Code、Cursor 和 VS Code 等 AI IDE 客户端控制。README 展示了通过 `plainhub-mcp` 安装的方式。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ricrio-inc-plainhub": {
      "command": "npx",
      "args": [
        "-y",
        "plainhub"
      ]
    }
  }
}

启动命令npx -y plainhub

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmplainhub1.5.2stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
line	number	否	要跳转到的行号
path	string	否	仓库中的文件路径，例如 docs/setup.md
repo	string	否	GitHub 仓库，格式为 owner/name，例如 octocat/hello-world
theme	enum	否	编辑器主题dark \| light
branch	string	否	分支名称（默认：仓库的默认分支）
header	enum	否	显示页眉on \| off
noAuth	boolean	否	设为 false 可将已保存的令牌传递给页面（默认：浏览器会自行登录）
scroll	string	否	将预览滚动到此标题（章节名称）
preview	enum	否	Markdown 预览on \| off
sidebar	enum	否	显示文件侧边栏on \| off
fontSize	number	否	字号（滑块范围 8-72，输入框接受任意值）
whitespace	enum	否	显示空白字符on \| off
lineNumbers	enum	否	显示行号on \| off

详细介绍

PlainHub

你的 AI 在 GitHub 中工作，由你做主。

一款连接 Claude Code 的 GitHub 编辑器：你的 Agent 会在你自己的仓库中共享进度记录和决策卡片，你可以通过浏览器或手机进行审批。

网站 · ▶ 30 秒介绍（YouTube） · 文档 · 日语文档

PlainHub：写下一条笔记，它会保存为一次提交；查看历史记录，然后让 AI 编辑并应用修改

三种使用方式

1. 编辑 — 打开、编写、保存

打开 GitHub 仓库中的文件，编写并保存——无需了解 Git。每次保存都会在你自己的仓库中生成一次提交。向 AI 询问当前文件相关的问题，并在应用前检查每项建议的修改。→ 用户指南

2. 进度记录 — 在仓库中记录进度和决策卡片

你的 Agent 会将消息和决策卡片写成 Markdown 文件，存放在你自己仓库的 .agents/ 中。运行 plainhub ledger sync . 将其发送到 GitHub，然后在 PlainHub 中打开该仓库。只要你有写入权限，就能在电脑或手机上看到待处理的决策卡片，并通过“批准”和“拒绝”按钮进行处理。开始使用进度记录只需 Git 和 Node.js 18 或更高版本。→ 如何使用进度记录

3. 你的 Agent — 连接你自己的 Claude Code

在 PlainHub AI 面板中提问，你自己电脑上的 Claude Code 就会作答——无论你使用的是同一台电脑还是手机。无需 API 密钥：它使用你的 Claude 订阅。→ 你的 Agent

为什么选择 PlainHub

原生支持 GitHub — 你的文件只保存在你自己的 GitHub 仓库中。PlainHub 不会存储这些文件。
文件内容绝不会经过 PlainHub 的服务器 — 文件读取和保存直接在浏览器与 GitHub API 之间进行。登录需要经过一个简短的服务器步骤——详见隐私政策。
BYOK（自带密钥） — 使用你自己的 AI API 密钥（例如 Anthropic Claude）。密钥保存在浏览器中，绝不会发送到 PlainHub 服务器。
用 AI 开发创意 — 与 AI 助手一起构思、编写和编辑。支持语音输入和 TTS 朗读。
面向 GitHub 的前端 — 类似 github.dev，但面向非工程师。内置版本控制的记事本。

功能

用手机编辑

在手机上打开一条笔记，修改一行并保存——修改会作为一次提交保存在你自己的仓库中。

在手机上编辑 Markdown 检查清单：切换到 Code，添加一行，页面显示已保存，并且提交会出现在 GitHub 历史记录中

编辑器

Markdown 三种编辑模式 — Code / Visual（所见即所得）/ Preview
语法高亮 — Markdown、JSON、YAML 等
撤销 / 重做 — 完整的编辑历史记录
行号、自动缩进、自动换行 — 可配置
空白字符可视化 — 切换显示不可见字符
键盘快捷键 — VS Code 风格的快捷键（Ctrl+S、Ctrl+Z 等）

文件管理

创建 / 重命名 / 复制 / 删除文件和文件夹
文件历史记录 — 查看过去的版本和差异
同步与冲突解决 — 与 GitHub 实时同步
粘贴图像 — 直接粘贴图像，自动上传到仓库
跨仓库搜索 — 搜索所有仓库

集成

CLI — 在终端中运行 plainhub open <file> -r <repo>
MCP 服务 — 从 AI IDE（Claude Code、Cursor、VS Code）进行控制
深层链接 — 分享带有主题、字体大小和行号设置的 URL
PWA — 在桌面和移动设备上安装为原生应用

设计

深色 / 浅色主题 — 自动或手动切换
适配移动设备 — 在手机和平板上提供完整功能

快速开始

Web

访问 plainhub.dev 并使用 GitHub 登录。

CLI

npm install -g plainhub
plainhub auth --from-gh
plainhub open README.md -r owner/repo

MCP 服务（AI IDE）

npm install -g plainhub
claude mcp add plainhub -- plainhub-mcp

然后说：“在 PlainHub 中打开 owner/repo 的 README”

文档

用户指南 — 编辑器功能和快捷键
功能 — 主要功能、数据所有权、企业版
使用场景 — 何时以及如何使用 PlainHub
CLI 参考 — 终端命令和选项
MCP 服务 — AI IDE 集成
你的 Agent — 将你自己的 Claude Code 连接到 AI 面板
常见问题 — 故障排除和常见问题
日本語ドキュメント — 日文文档

提问 / 报告

提出问题或报告问题：提交 issue——再小的问题也欢迎提出。我们通常会在 2 个工作日内回复。

❓ 如何……？ — 询问如何执行某项操作
🐞 Bug — 某项功能未按预期工作
💡 想法 — 提出改进建议

回复可能会在 AI 助手的帮助下起草，并由 PlainHub 团队审核。请勿发布个人信息、令牌或私有文件内容——此代码库是公开的。

链接

应用：app.plainhub.dev
关于：plainhub.dev

如果 PlainHub 对你有帮助，请点个星标，让更多人发现它。

许可证

_{此代码库中的文档由其他位置生成，请勿在此处编辑。如需修正，请通过 issue 告诉我们。}

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。