Grip

grip

Grip is a command-line server application written in Python that uses the GitHub markdown API to render a local readme file.

Runs as grip|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 10 fields

Serve a Markdown file or README as GitHub-rendered HTML, or export it to a file. GitHub credentials, API URL and user-content rendering options are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui grip

Preview or export MarkdownExample values, fixed in this page — nothing here reaches a terminal

Basic

Markdown file or directory

any

Port or host:port (or output file with export)

string

Open in browser

--browser

Theme

2 choicesenum

Advanced

Disable auto-refresh

--norefresh

TasksEach one presets the form for one job

Preview in browser

pathaddressbrowserthemenorefresh

Export to HTML

pathaddressexportno_inlinethemetitle

ParametersOnly these flags are editable in the form

Markdown file or directory

File to render, or a directory containing README.md. Leave empty for the current directory.
path · positional 0

Port or host:port (or output file with export)

Listen address such as 6419 or localhost:8080. With Export it is the output file instead.
string · positional 1

Open in browser

boolean

--browser-b

Export HTML instead of serving

boolean

--export

Link styles instead of inlining

Only meaningful together with Export.
boolean

--no-inline

Theme

enum

--themelightdark

Page title

string

--title

Disable auto-refresh

boolean

--norefresh

Wide layout

boolean

--wide

Quiet

boolean

--quiet

SourcesEvery flag above is checked against these

help

Usage: grip [options] [<path>] [<address>] Where: <path> is a file to render or a directory containing README.md (- for stdin) <address> is what to listen on, of the form <host>[:<port>], or just <port> Options: --export Exports to <path>.html or README.md instead of serving, optionally using [<address>] as the out…

helpmaster 2026-10-27

github.com

Before it fills your prompt, Otty checks the installed grip against its version. A form that does not match your version is not offered.