diff --git a/README.md b/README.md
index d0a18b8..fbe3b7e 100644
--- a/README.md
+++ b/README.md
@@ -478,10 +478,12 @@ Destinations are the OTLP/HTTP endpoints sessions export to, managed per project
 
 - `kernel browsers computer press-key <id>` - Press one or more keys
 
-  - `--key <key>` - Key symbols to press (repeatable)
+  - `--key <key>` - One X11 keysym or chord, such as `Return`, `Ctrl+t`, or `Ctrl+minus` (repeatable)
   - `--duration <ms>` - Duration to hold keys down in ms (0=tap)
   - `--hold-key <key>` - Modifier keys to hold (repeatable)
 
+  Pass sequential or repeated key presses as separate `--key` values, for example `--key BackSpace --key BackSpace`. Use `computer type --text` to enter text instead of passing text to `press-key`.
+
 - `kernel browsers computer scroll <id>` - Scroll the mouse wheel
 
   - `--x <coordinate>` - X coordinate (required)
diff --git a/cmd/browsers.go b/cmd/browsers.go
index caf2cfe..02a48a3 100644
--- a/cmd/browsers.go
+++ b/cmd/browsers.go
@@ -2879,7 +2879,7 @@ func init() {
 
 	// computer press-key
 	computerPressKey := &cobra.Command{Use: "press-key <id>", Short: "Press one or more keys", Args: cobra.ExactArgs(1), RunE: runBrowsersComputerPressKey}
-	computerPressKey.Flags().StringSlice("key", []string{}, "Key symbols to press (repeatable)")
+	computerPressKey.Flags().StringSlice("key", []string{}, "One X11 keysym or chord per value, e.g. Return, Ctrl+t, or Ctrl+minus (repeatable)")
 	_ = computerPressKey.MarkFlagRequired("key")
 	computerPressKey.Flags().Int64("duration", 0, "Duration to hold keys down in ms (0=tap)")
 	computerPressKey.Flags().StringSlice("hold-key", []string{}, "Modifier keys to hold (repeatable)")