diff --git a/README.asciidoc b/README.asciidoc
index 3977c12d4..45b73b41b 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -65,6 +65,9 @@ link:#layouts[layouts] without needing to use an extra program like tmux
 
 * Can be link:remote-control.asciidoc[controlled from scripts or the shell prompt], even over SSH.
 
+* Has a framework for _kittens_, small terminal programs that can be used to extend kitty's functionality.
+For example, they are used for link:#unicode-input[Unicode input] and link:#url-hints[URL hints].
+
 * Supports link:#startup-sessions[startup sessions] which allow you to specify the window/tab layout,
 working directories and programs to run on startup.
 
@@ -72,10 +75,9 @@ working directories and programs to run on startup.
 it uses only OpenGL for rendering, it should be trivial to port to other
 platforms.
 
-* Allows you to open the scrollback buffer and window contents in a separate
+* Allows you to open link:#the-scrollback-buffer[the scrollback buffer] in a separate
 window using arbitrary programs of your choice. This is useful for browsing
-the history comfortably in a pager or editor and also for doing things like
-opening URLs using only the keyboard.
+the history comfortably in a pager or editor.
 
 
 image::screenshot.png?raw=true[Screenshot, showing three programs in the "Tall" layout]
@@ -258,6 +260,20 @@ which will open the scrollback buffer in your favorite pager program (which is
 the scrollback pager comfortably within the pager.
 
 
+== Input unicode
+
+You can input unicode characters by name, hex code, recently used and even an editable favorites list.
+Press {sc_input_unicode_character} to start the unicode input widget, shown below.
+
+image::unicode.png?raw=true[Unicode input widget, showing selection of unicode characters by name]
+
+== URL hints
+
+kitty has a _hints mode_ to click URLs visible on the screen by using only the keyboard.
+Press {sc_run_simple_kitten_text_url_hints} to activate hints mode, as shown below.
+
+image::hints_mode.png?raw=true[URL hints mode]
+
 == Miscellaneous features
 
 You can double click to select a word and triple click to select a line. You can also
diff --git a/hints_mode.png b/hints_mode.png
new file mode 100644
index 000000000..fe9fa365f
Binary files /dev/null and b/hints_mode.png differ
diff --git a/unicode.png b/unicode.png
new file mode 100644
index 000000000..44b06b188
Binary files /dev/null and b/unicode.png differ