diff --git a/include/ghostty/vt.h b/include/ghostty/vt.h
index 33ff2a961..a33d2c9ee 100644
--- a/include/ghostty/vt.h
+++ b/include/ghostty/vt.h
@@ -11,6 +11,26 @@
  * stable and is definitely going to change. 
  */
 
+/**
+ * @mainpage libghostty-vt - Virtual Terminal Sequence Parser
+ *
+ * libghostty-vt is a C library which implements a modern terminal emulator,
+ * extracted from the [Ghostty](https://ghostty.org) terminal emulator.
+ *
+ * libghostty-vt contains the logic for handling the core parts of a terminal
+ * emulator: parsing terminal escape sequences and maintaining terminal state.
+ * It can handle scrollback, line wrapping, reflow on resize, and more.
+ *
+ * @warning This library is currently in development and the API is not yet stable.
+ * Breaking changes are expected in future versions. Use with caution in production code.
+ *
+ * @section groups_sec API Reference
+ *
+ * The API is organized into the following groups:
+ * - @ref osc "OSC Parser" - Parse OSC (Operating System Command) sequences
+ *
+ */
+
 #ifndef GHOSTTY_VT_H
 #define GHOSTTY_VT_H