skill
repoglyph-py
Local OKF bundle generator: details file/line churn, change-coupling, and generates a banner for at-a-glance structural fingerprints.
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/remsky/repoglyph-py itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 21, 2026repoglyph
+Open Knowledge Format bundle generator showing repo churn, file change coupling, and structural fingerprint.
+Isometric repo-city banners from local git clone.
(Offline port of repoglyph.net; hosted (free) customization explorer and web-cached banners there.)
Install
Standalone CLI on PATH
uv tool install "repoglyph"
OR CLI in the active environment
pip install "repoglyph"
Each installs the repoglyph command. Python 3.12+. Use repoglyph[png] to include the extra for PNG output
Usage
A usage skill for repoglyph itself can be installed via npx skills, plugin marketplace, or found in this repo (plugin/skills/repoglyph)
npx skills add remsky/repoglyph-py
OR
claude plugin marketplace add remsky/repoglyph-py
claude plugin install repoglyph@repoglyph
Basic 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.
All flags
| 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 |
--svg / --no-svg | on for a banner, off with --okf/--skill | write the SVG |
--png / --no-png | on for a banner, off with --okf/--skill | write the PNG (needs the png extra) |
--skip-commons | off | drop lockfiles from the city |
--staged | off | draw HEAD + staged changes |
--okf [DIR] | off | write an OKF context bundle |
--skill [DIR] | off | skill-compliant OKF bundle (default .claude/skills/repo-map) |
--inventory | off | add per-district docs with full file listings to the bundle |
--cache | off | save repo data for --from-cache |
repoglyph --help for the rest.
Styles
oblique: flat cabinet-oblique map (default)skyline: one building per filehighrise: one tower per district, floors are subdirs
OKF / Skill Generation
--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 a per-district stats table (files, bytes, depth,
churn, largest file). That's a flat handful of documents by default;
--inventory adds one document per district with its full file listing. A
reader working in a checkout can list files itself, so the default bundle
carries only what a listing can't show. In bundle mode no banner is drawn; add
--svg or --png if you also want the image.
See it live: the glyph branch
holds the bundle for this repo, regenerated by CI on every push to main.
repoglyph . --okf
Or shortcut with --skill to generate with skill-compliant filenames and frontmatter, so an agent can quickly get its bearings on any repo.
repoglyph . --skill # -> .claude/skills/repo-map
repoglyph . --skill <custom output path>
- 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.