plainhub

v1.2.0

Published

17 days ago

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

0High
0Medium
0Low

plainhub

plainhub github editor mcp mcp-server cli notepad ai

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 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

MCP Server Tools

| Tool | Description | |------|-------------| | plainhub_open | Open a file or change editor settings | | 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

License

MIT