aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorAhmed <git@gumx.cc>2026-06-14 01:49:48 +0300
committerAhmed <git@gumx.cc>2026-06-14 01:49:48 +0300
commit41f8d3025f041aaab98fcc3511cb6ec2198f76a7 (patch)
treec147d5a547c3e2d7b49546157f324cbd80e88c48 /README.md
init: vibed
Diffstat (limited to 'README.md')
-rw-r--r--README.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..63b0f8a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# ugi
+
+Universal Geek Identifier. Spec, CLI, and web tool.
+
+## Contents
+
+- `spec/`: UGI specification, registry JSON, grammar files, generation scripts
+- `cli/`: `ugi` shell script for encoding and decoding from the command line
+- `web/`: web tool generated from the registry; run `gen_tool.py` to rebuild
+- `fonts/`: Kawkab Mono typeface used by the web tool
+
+## Build web tool
+
+```sh
+python3 web/scripts/gen_tool.py spec/ugi_registry_v0.json web/index.html
+```
+
+## Links
+
+- Live tool: <https://ugi.gumx.cc>
+- Spec: `spec/README.md`
+- CLI: `cli/README.md`