diff --git a/README.md b/README.md
index 74a0a26..45b349b 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,25 @@
 ### mips toolchain
 
-lots to do still
+a full mips r2000 toolchain with a assembler and linker
 
-do not use the
+- plan to implement the rest of the mips32r6 instructions
+
+outputs MIPS32r6 ELF32 Big Endian executables
+
+#### masm
+
+the assembler
+
+`usage: masm [options] source.asm`
+
+#### mld
+
+the linker
+
+`usage: mld [options] objfile...`
+
+#### msim
+
+the emulator
+
+- i havent wrote it yet