From 9a01a128520e8ca3caa7acf2feca167bdff335a6 Mon Sep 17 00:00:00 2001
From: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com>
Date: Wed, 23 Sep 2026 15:43:05 +0800
Subject: [PATCH] docs(prompt): describe the input moving below a long prompt
 (#767)

---
 docs/terminal/prompt.mdx | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/terminal/prompt.mdx b/docs/terminal/prompt.mdx
index 075e8b4b..b10708c9 100644
--- a/docs/terminal/prompt.mdx
+++ b/docs/terminal/prompt.mdx
@@ -98,6 +98,13 @@ A command that wraps, or one you deliberately break across lines, edits in
 place. The grid shifts to keep the caret visible instead of scrolling the whole
 screen away.
 
+When the prompt itself takes up most of the row — a deep working directory, a
+busy theme — the line you type starts on the row below it instead, with the
+full width of the pane. That happens once the prompt leaves fewer than a third
+of the columns (never fewer than 20); an ordinary prompt keeps the input beside
+it. To keep the prompt short instead, trim it in the shell: `%2~` in a zsh
+`PROMPT`, fish's `prompt_pwd`, or starship's `truncation_length`.
+
 | | |
 |---|---|
 | <kbd>⇧ ⏎</kbd> · <kbd>⌥ ⏎</kbd> | Insert a newline instead of submitting |