Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (plainhub) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

PlainHub

Frontend for GitHub. 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

License

MIT

plainhub