initial readme

1 files changed, 26 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..01c93e8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# `tri`
+
+This repository contains some basic tools for experimentation with my trinary
+instruction set architecture.
+
+# `core`
+
+Central things related to trinary arithmetic, register naming and instruction
+encoding/decoding.
+
+# `tasm`
+
+Trinary assembler.
+
+# `tdump`
+
+Trinary `objdump`
+
+# `triscv`
+
+Trinary ISA simulator.
+
+# `utf9`
+
+Helper stuff related to trinary text handling, effectively encodes UTF-8 as
+trinary numbers.