geml plugin
Author, validate, and blockwise-edit GEML documents, and navigate a project's call graph as GEML codemaps: two skills plus the geml MCP server (runs via npx @geml/geml, no separate install).
How to install the geml plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add geml-spec/geml
/plugin install geml@gemlWhat's inside geml
3 parts read from the plugin's own files.
Skills 2
Claude loads it when the task matches- geml
Address a document by its BLOCKS instead of reading it whole. Use for any long Markdown or documentation file — README, spec, guide, design doc, changelog — when the job is to find where something is documented, read one section, or change one section: `geml list`, `geml find` and `geml get` read Markdown directly and hand back the one block that matters, leaving the file the Markdown it already was. Skip it when the whole file is short enough to read anyway. Use it also to read, author, edit or validate GEML itself — .geml files, .gemlhistory sidecars, typed blocks, === fences, geml-chart, converting Markdown to GEML — where the output must parse cleanly (zero error diagnostics) against the reference parser.
- geml-code-graph
Build, view, update, and navigate a project's call graph as GEML codemap documents. Use when asked to see/update/build a project's code graph or codemap (看下/更新下 code-graph), when asked "who calls X" / "what does X call" / to trace a call chain or impact path, or whenever a .geml/codemap/ directory with index.geml and _index/name-lookup.json exists. Detects the project's languages itself — never asks the user; viewing ends with the browser OPEN on the graph.
Hooks 1
Runs on these events- SessionStartcommand
No description in the file.
Using geml in Claude Code
Skills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update geml@geml
- Refresh the marketplace
- /plugin marketplace update geml
- Turn it off for now
- /plugin disable geml@geml
- Remove it
- /plugin uninstall geml@geml
Skills in geml
- gemlgeml-spec/geml
Address a document by its BLOCKS instead of reading it whole. Use for any long Markdown or documentation file — README, spec, guide, design doc, changelog — when the job is to find where something is documented, read one section, or change one section: `geml list`, `geml find` and `geml get` read Markdown directly and hand back the one block that matters, leaving the file the Markdown it already was. Skip it when the whole file is short enough to read anyway. Use it also to read, author, edit or validate GEML itself — .geml files, .gemlhistory sidecars, typed blocks, === fences, geml-chart, converting Markdown to GEML — where the output must parse cleanly (zero error diagnostics) against the reference parser.
3 files31stars - geml-code-graphgeml-spec/geml
Build, view, update, and navigate a project's call graph as GEML codemap documents. Use when asked to see/update/build a project's code graph or codemap (看下/更新下 code-graph), when asked "who calls X" / "what does X call" / to trace a call chain or impact path, or whenever a .geml/codemap/ directory with index.geml and _index/name-lookup.json exists. Detects the project's languages itself — never asks the user; viewing ends with the browser OPEN on the graph.
31stars
geml plugin questions
How do I install the geml plugin?
In Claude Code run /plugin marketplace add geml-spec/geml, then /plugin install geml@geml.
What does the geml plugin include?
geml bundles 2 skills, hooks.
How do I update or remove the geml plugin?
Update it with claude plugin update geml@geml in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall geml@geml.
What license is the geml plugin under?
MIT, as stated in the plugin's manifest.