Repoglyph
Local OKF bundle generator: details file/line churn, change-coupling, and generates a banner for at-a-glance structural fingerprints.
npx -y skills add remsky/repoglyph-py --skill repoglyphAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 29 days oldThe repository was created 29 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Generate isometric repo-city banners and OKF structural context bundles from a local git clone with the repoglyph CLI. Use when the user wants a repo banner image, a codebase map, an agent-readable repo summary, or a self-updating repo-map skill.
SKILL.md
3.3 KB, as published. Nobody here has run it
<img src="https://raw.githubusercontent.com/remsky/repoglyph-py/main/assets/logo.svg" width="28" height="28" alt=""> repoglyph
Isometric repo-city banners from a local git clone. Each file is a building: size drives height, type drives color, recent commits light windows.
Offline port of repoglyph.net; hosted (free) customization explorer and web-cached banners there.
Install
uv tool install "repoglyph[png]" # standalone CLI on PATH
pip install "repoglyph[png]" # CLI in the active environment
uv add --dev "repoglyph[png]" # project dev dependency (CI, hooks)
Each installs the repoglyph command. Python 3.12+. Drop the png extra for
SVG-only output.
Usage
repoglyph # current repo w/ defaults
repoglyph ../project
repoglyph . --style skyline --palette neon
Writes <repo>/.glyph/<owner>_<repo>_<style>.svg, plus a PNG with the png extra.
| Flag | Default | Meaning |
|---|---|---|
--commits N | 50 | commits used for lit windows |
--style NAME | oblique | oblique, skyline, or highrise |
--palette NAME|FILE | light | built-in theme or palette JSON |
--size WxH | 1280x480 | canvas size |
--full | off | fit canvas to the whole city |
--out FILE | auto | output SVG path |
--out-dir DIR | <repo>/.glyph | folder for all outputs |
--no-png | off | skip PNG output |
--skip-commons | off | drop lockfiles from the city |
--staged | off | draw HEAD + staged changes |
--okf [DIR] | off | write an OKF context bundle |
--skill | off | add a SKILL.md to the OKF bundle |
--cache | off | save repo data for --from-cache |
repoglyph --help for the rest.
oblique: flat cabinet-oblique map (default)skyline: one building per filehighrise: one tower per district, floors are subdirs
OKF
--okf writes markdown context files from the same repo data: an index, a
repository summary, hotspots (churn ranking plus change-coupling hubs mined
from commit history), and one file per district.
Add --skill and point it at a skills folder to ship the bundle as a
self-updating map-of-the-codebase agent skill:
repoglyph . --okf .claude/skills/repo-map --skill
That one command is the whole install: Claude Code discovers anything under
.claude/skills/ automatically. Commit the folder and every clone has it.
This repo is also a Claude Code plugin marketplace for itself; the plugin ships a usage skill so Claude knows how to run repoglyph:
claude plugin marketplace add remsky/repoglyph-py
claude plugin install repoglyph@repoglyph
- Shows folder structure, not runtime architecture.
- Lit windows and coupling use the sampled commit window, not full history.
- File bytes proxy size.
Contributing
See CONTRIBUTING.md.
License
Apache-2.0. Bundled Monaspace Xenon fonts are SIL OFL.