diff --git a/src/hwylterm/hwylcli.nim b/src/hwylterm/hwylcli.nim
index 0366885..41fa29e 100644
--- a/src/hwylterm/hwylcli.nim
+++ b/src/hwylterm/hwylcli.nim
@@ -721,6 +721,7 @@ func hwylCliImpl(cfg: CliCfg, root = false): NimNode =
       `runProcName`(`args`[1..^1])
 
 macro hwylCli*(body: untyped) =
+  ## generate a CLI styled by `hwylterm` and parsed by `parseopt3`
   var cfg = parseCliBody(body)
   hwylCliImpl(cfg, root = true)