diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c789e0a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+Single cycle RISC-V cpu in verilog.
+Supported instructions are:
+add, addi, and, sub, slt, div, beq, blt, lw, sw, lui, jal, jalr, auipc, sll, srl, sra