plainhub

Name: plainhub
Author: ricrio-inc

Local

github.com/ricrio-incProductivity2Updated 1d ago

Repository

About plainhub

PlainHub is a GitHub-based editor and approval interface for people working with Claude Code. It edits repository files, presents agent progress and decision cards for review, and connects an AI panel to a user's own Claude Code.

Key features

01Edit GitHub files in a browser
02Markdown code, visual, and preview modes
03Review agent progress and decision cards
04Browse file history and diffs
05Search across repositories

Use cases

01Edit and commit a repository file from a phone
02Approve or decline an agent decision remotely
03Review earlier file versions and changes

MCP support

PlainHub includes an MCP server that lets AI IDE clients such as Claude Code, Cursor, and VS Code control it. The README shows installation through `plainhub-mcp`.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commandnpx -y plainhub

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmplainhub1.5.2stdio

Tools

Saved tool list · updated 1w ago

Parameter	Type	Required	Description
line	number	No	Line number to jump to
path	string	No	File path in the repository, e.g. docs/setup.md
repo	string	No	GitHub repository as owner/name, e.g. octocat/hello-world
theme	enum	No	Editor themedark \| light
branch	string	No	Branch name (default: the repository's default branch)
header	enum	No	Show the headeron \| off
noAuth	boolean	No	Set to false to hand the saved token to the page (default: the browser signs in on its own)
scroll	string	No	Scroll the preview to this heading (section name)
preview	enum	No	Markdown previewon \| off
sidebar	enum	No	Show the file sidebaron \| off
fontSize	number	No	Font size (slider 8-72, input accepts any)
whitespace	enum	No	Show whitespaceon \| off
lineNumbers	enum	No	Show line numberson \| off

Details

From the project README

PlainHub

Your AI works in your GitHub. You decide.

A GitHub editor, wired to Claude Code: your agent keeps a shared ledger of progress and decision cards in your own repo, and you approve from your browser or phone.

Website · ▶ 30-second intro (YouTube) · Documentation · 日本語ドキュメント

PlainHub: write a note, it is saved as a commit, check the history, ask AI for an edit and apply it

Three ways to use it

1. Edit — open, write, save

Open a file in your GitHub repositories, write, and save — no Git knowledge required. Every save is a commit in your own repository. Ask the AI about the file in front of you, and review each proposed edit before it is applied. → User Guide

2. Ledger — progress and decision cards in your repo

Your agents write their messages and decision cards as Markdown files in .agents/ in your own repository. Send it to GitHub with plainhub ledger sync . and open the repository in PlainHub. If you can write to it, decision cards waiting for you show Approve and Decline buttons, on your PC or your phone. Starting a ledger needs only Git and Node.js 18 or later. → How to use the ledger

3. Your agent — connect your own Claude Code

Ask in the PlainHub AI panel, and Claude Code on your own PC answers — from the same PC or from your phone. No API key needed: it uses your Claude subscription. → Your agent

Why PlainHub

GitHub-native — Your files are saved only in your own GitHub repository. PlainHub doesn't store them.
File contents never pass through PlainHub's servers — Reading and saving go directly between your browser and the GitHub API. Sign-in uses a small server step — see the privacy policy.
BYOK (Bring Your Own Key) — Use your own AI API keys (e.g., Anthropic Claude). Keys stay in your browser, never sent to PlainHub servers.
AI for idea development — Brainstorm, write, and edit alongside an AI assistant. Voice input and TTS read-aloud supported.
Frontend for GitHub — Like github.dev, but for non-engineers. A notepad with version control built in.

Features

Edit from your phone

Open a note on your phone, fix a line, and it is saved — as a commit in your own repository.

Editing a Markdown checklist on a phone: switch to Code, add a line, it shows Saved, and the commit appears in the GitHub history

Editor

Markdown 3-mode editing — Code / Visual (WYSIWYG) / Preview
Syntax highlighting — Markdown, JSON, YAML, and more
Undo / Redo — Full edit history
Line numbers, auto-indent, line wrapping — Configurable
Whitespace visualization — Toggle invisible characters
Keyboard shortcuts — VS Code-style shortcuts (Ctrl+S, Ctrl+Z, etc.)

File Management

Create / rename / duplicate / delete files and folders
File history — View past versions with diff
Sync & conflict resolution — Real-time sync with GitHub
Image paste — Paste images directly, auto-upload to repo
Cross-repo search — Search across all your repositories

Integration

CLI — plainhub open <file> -r <repo> from your terminal
MCP Server — Control from AI IDE (Claude Code, Cursor, VS Code)
Deep linking — Share URLs with theme, font size, line number settings
PWA — Install as native app on desktop and mobile

Design

Dark / Light theme — Automatic or manual
Mobile responsive — Full-featured on phone and tablet

Quick Start

Web

Visit plainhub.dev and sign in with GitHub.

CLI

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

MCP Server (AI IDE)

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

Then say: "Open the README in owner/repo on PlainHub"

Documentation

User Guide — Editor features and shortcuts
Features — Key features, data ownership, enterprise
Use Cases — When and how to use PlainHub
CLI Reference — Terminal commands and options
MCP Server — AI IDE integration
Your agent — Connect your own Claude Code to the AI panel
FAQ — Troubleshooting and common questions
日本語ドキュメント — Japanese documentation

Ask / Report

Ask a question or report a problem: open an issue — no question is too small. We usually reply within 2 business days.

❓ How do I…? — ask how to do something
🐞 Bug — something doesn't work as expected
💡 Idea — suggest an improvement

Replies may be drafted with the help of an AI assistant and are checked by the PlainHub team. Please don't post personal information, tokens, or private file contents — this repository is public.

License

_{The documents in this repository are generated from another place, so please don't edit them here. If something needs fixing, let us know with an issue.}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.