diff --git a/src/hwylterm/hwylcli.nim b/src/hwylterm/hwylcli.nim
index a520fa7..b5d13fe 100644
--- a/src/hwylterm/hwylcli.nim
+++ b/src/hwylterm/hwylcli.nim
@@ -1,5 +1,30 @@
 ##[
   # HwylCli
+
+  ## example program:
+
+  ```nim
+  import std/[strutils]
+  import hywlterm/hwylcli
+
+  hwylCli:
+    name "example"
+    flags:
+      count:
+        ? "# of times"
+        - n
+      input:
+        ? "content"
+        - i
+    run:
+      echo (input & " ").repeat(count)
+  ```
+
+  ```
+  $ example -n 2 --input "testing"
+  > testing testing
+  ```
+
 ]##
 
 import std/[