plainhub

PlainHub

GitHub-native notepad. CLI and MCP Server for AI IDE integration.

Open, edit, save — directly to your repo. No server, no database.

Install

npm install -g plainhub

Quick Start

CLI

plainhub auth --from-gh        # Import auth from gh CLI (recommended)
plainhub open README.md -r owner/repo
plainhub browse -r owner/repo  # Open file browser

MCP Server (Claude Code)

claude mcp add plainhub -- plainhub-mcp

Then say: "Open the README in PlainHub"

MCP Server (Cursor)

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "plainhub": {
      "command": "plainhub-mcp"
    }
  }
}

CLI Usage

Commands

Command	Description
plainhub open <file>	Open a file in PlainHub
plainhub diff <sha>	Show commit diff in PlainHub
plainhub browse	Open repository file browser
plainhub auth	Authenticate with GitHub PAT
plainhub auth --from-gh	Import token from gh CLI
plainhub auth --status	Show auth status
plainhub auth --logout	Remove saved token

Options

Option	Value	Description
-r, --repo	owner/name	Repository
-b, --branch	string	Git branch
-l, --line	number	Jump to line
-n		Print URL only (don't open browser)
--theme	dark/light	Editor theme
--preview	on/off	Markdown preview
--scroll	string	Scroll to heading in preview
--sidebar	on/off	Show sidebar
--fontSize	10-32	Font size
--lineNumbers	on/off	Show line numbers
--whitespace	on/off	Show whitespace
--no-auth		Open without saved token

Examples

plainhub open docs/API.md -r owner/repo --preview on
plainhub open src/App.tsx -r owner/repo -l 42 --theme light
plainhub open README.md -r owner/repo -n  # Print URL only
plainhub diff abc1234 -r owner/repo       # Show commit diff
plainhub diff abc1234 -r owner/repo --path src/main.js  # Diff for specific file

MCP Server Tools

Tool	Description
plainhub_open	Open a file or change editor settings
plainhub_diff	Show commit diff in PlainHub
plainhub_browse	Open repository file browser
plainhub_auth	Save a GitHub PAT
plainhub_auth_status	Check authentication status

Authentication

PlainHub supports three authentication methods:

• gh CLI import (recommended): plainhub auth --from-gh
• Manual PAT: plainhub auth — opens GitHub token settings
• Web UI: Enter PAT directly in the browser

Tokens are saved to ~/.config/plainhub/token with 0600 permissions (owner-only read/write).

Security

• Tokens are stored locally with restrictive file permissions (0600)
• URL fragments (#token=...) are never sent to servers per HTTP spec
• Fragments are cleared from browser history immediately after use
• No intermediary servers — browser communicates directly with GitHub API

Links

• Homepage
• Documentation
• Report an Issue

License

MIT