GSL
Text DSL for storing graphs as versioned source of truth and deriving diagrams and reports via queries.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Go 1.26 or newer
download and install prebuilt gsl-query and gsl-diagram binaries from GitHub releases
curl -fsSL -o /tmp/gsl2.tar.gz https://github.com/dnnrly/gsl-lang/releases/download/v0.7.0/gsl-lang_0.7.0_linux_amd64.tar.gz && tar -xzf /tmp/gsl2.tar.gz -C /tmp && cp /tmp/gsl-query /tmp/gsl-diagram ~/.local/bin/
Check that it works
gsl-query versionThe output should contain “gsl-query version 0.7.0”.
First thing to try
gsl-query versionRun gsl-query version to confirm the tool is installed, then pipe a .gsl file into gsl-query with a query.
What it does
- Make diagrams and views from one graphTested
How to use it
- Write your graph in a .gsl file using
nodeand->edge lines. - Run
gsl-query 'from *' < <file> | gsl-diagram -f mermaid -t componentto get a Mermaid component diagram.
- Write your graph in a .gsl file using
- Find what is affected when a service is retiredTested
How to use it
- Tag important nodes with a set, such as
@critical, in your .gsl file. - Run
gsl-query '(subgraph node.id == "<service>" traverse in all) as BLAST | from * | (subgraph node in @critical) as CRIT | BLAST & CRIT' < <file>to list the critical edges that depend on that serv
- Tag important nodes with a set, such as
- Model prerequisites between workflow edgesTested
How to use it
- Name edges with a label (such as
GATE:) and link them withparent=<label>or by nesting edges in{ }blocks. - Run
gsl-query 'subgraph edge depends on edge.stage == "<stage>" scope' < <file>to list edges that depend on a given stage.
- Name edges with a label (such as
How far pickfit got
Linux x86_64
- Installs
- Starts
- 3 of 3 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- Keep architecture docs truthful from one canonical model
- Reconstruct an undocumented system with provenance attributes
- Model workflow prerequisites with edges depending on edges
- Model financial, org and other relationship networks
An alternative to Mermaid, D2, Graphviz / DOT, Graph databases (Neo4j) and Structurizr / C4 DSL.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 0.7.0
Differences the test machine hit
- README: go install github.com/dnnrly/gsl-lang/cmd/gsl-query@latest requires Go 1.26 or newer
In the test: Go toolchain not available in box; used prebuilt binaries from GitHub releases (gsl-lang_0.7.0_linux_amd64.tar.gz) which need no Go