grip
brew install grip
v4.6.2_21
MIT
GitHub Markdown previewer
540
30-day installs · #1699
2.0k
90-day · #1583
5.6k
365-day · #1849
6.8k
★ GitHub stars · updated 2y ago
Runtime dependencies
GitHub topics
commandline-interface
flask
github
html
python
readme
Links
- https://github.com/joeyespo/grip
- GitHub: joeyespo/grip
- Brew formula source: Formula/g/grip.rb
Raw metadata
{
"aliases": [],
"alternatives": [],
"build_dependencies": [],
"categories": [],
"caveats": null,
"conflicts_with": [],
"dependencies": [
"certifi",
"python@3.14"
],
"deprecated": 0,
"deprecation_reason": null,
"desc": "GitHub Markdown previewer",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:38:26+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "grip",
"github_default_branch": "master",
"github_last_commit_at": "2024-07-10T06:39:28Z",
"github_readme_excerpt": "Grip -- GitHub Readme Instant Preview\n=====================================\n\n[][pypi]\n[](https://saythanks.io/to/joeyespo)\n\nRender local readme files before sending off to GitHub.\n\nGrip is a command-line server application written in Python that uses the\n[GitHub markdown API][markdown] to render a local readme file. The styles\nand rendering come directly from GitHub, so you\u0027ll know exactly how it will appear.\nChanges you make to the Readme will be instantly reflected in the browser without\nrequiring a page refresh.\n\n\nMotivation\n----------\n\nSometimes you just want to see the exact readme\nresult before committing and pushing to GitHub.\n\nEspecially when doing [Readme-driven development][rdd].\n\n\nInstallation\n------------\n\nTo install grip, simply:\n\n```console\n$ pip install grip\n```\n\nOn OS X, you can also install with Homebrew:\n\n```console\n$ brew install grip\n```\n\n\nUsage\n-----\n\nTo render the readme of a repository:\n\n```console\n$ cd myrepo\n$ grip\n * Running on http://localhost:6419/\n```\n\nNow open a browser and visit [http://localhost:6419](http://localhost:6419/).\nOr run with `-b` and Grip will open a new browser tab for you.\n\nYou can also specify a port:\n\n```console\n$ grip 80\n * Running on http://localhost:80/\n```\n\nOr an explicit file:\n\n```console\n$ grip AUTHORS.md\n * Running on http://localhost:6419/\n```\n\nAlternatively, you could just run `grip` and visit [localhost:6419/AUTHORS.md][AUTHORS.md]\nsince grip supports relative URLs.\n\nYou can combine the previous examples. Or specify a hostname instead of a port. Or provide both.\n\n```console\n$ grip AUTHORS.md 80\n * Running on http://localhost:80/\n```\n\n```console\n$ grip CHANGES.md 0.0.0.0\n * Running on http://0.0.0.0:6419/\n```\n\n```console\n$ grip . 0.0.0.0:80\n * Running on http://0.0.0.0:80/\n```\n\nYou can even bypass the server and **export** to a single HTML file, with all the styles and assets ",
"github_repo": "joeyespo/grip",
"github_stars": 6810,
"github_topics": [
"commandline-interface",
"flask",
"github",
"html",
"python",
"readme"
],
"homepage": "https://github.com/joeyespo/grip",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 540,
"installs_365d": 5605,
"installs_90d": 2033,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "MIT",
"llm_generated_at": null,
"llm_model": null,
"name": "grip",
"oldnames": [],
"one_liner": null,
"optional_dependencies": [],
"rank_30d": 1699,
"rank_365d": 1849,
"rank_90d": 1583,
"raw_hash": "609a8e78b128d1e0",
"recommended_dependencies": [],
"revision": 21,
"ruby_source_path": "Formula/g/grip.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": null,
"version_stable": "4.6.2",
"versioned_formulae": [],
"why_use_this": null
}