Skip to content

Commit 42daa91

Browse files
committed
fix: update sidebar label and enhance keyboard navigation documentation
1 parent 128b2a2 commit 42daa91

File tree

1 file changed

+61
-4
lines changed

1 file changed

+61
-4
lines changed

docs/features/keyboard-shortcuts.md

Lines changed: 61 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
sidebar_label: Keyboard Shortcuts
2+
sidebar_label: Keyboard Navigation
33
---
44

5-
# Keyboard Shortcuts
5+
# Keyboard Navigation
66

7-
The Roo Code interface supports keyboard shortcuts to streamline your workflow and reduce dependence on mouse interactions.
7+
The Roo Code interface supports keyboard navigation and shortcuts to streamline your workflow and reduce dependence on mouse interactions.
88

99
---
1010

@@ -16,6 +16,7 @@ Roo Code offers keyboard commands to enhance your workflow. This page focuses on
1616
|---------|-------------|-----------------|
1717
| `roo.acceptInput` | Submit text or accept the primary suggestion | None (configurable) |
1818
| `roo.focus` | Focus the Roo input box | None (configurable) |
19+
| Arrow Up/Down | Navigate through prompt history | Built-in |
1920

2021
### Key Benefits of Keyboard Commands
2122

@@ -160,4 +161,60 @@ The `roo.acceptInput` command is implemented as follows:
160161

161162
- Works only when the Roo interface is active
162163
- Has no effect if no inputs or suggestions are currently available
163-
- Prioritizes the primary (first) button when multiple options are shown
164+
- Prioritizes the primary (first) button when multiple options are shown
165+
166+
---
167+
168+
## Command Line Style Prompt History Navigation
169+
170+
Navigate your prompt history with a terminal-like experience using the arrow keys. This feature makes it easy to reuse and refine previous prompts, whether from your current conversation or past tasks.
171+
172+
### Key Features
173+
- **Up/Down Arrows**: Cycle through previous prompts.
174+
- **Context-Aware**: Switches between conversation and task history.
175+
- **Preserves Input**: Remembers what you were typing.
176+
177+
### Why This Matters
178+
179+
**Before**: Reusing a prompt meant scrolling up, copying, and pasting.
180+
- Tedious and slow
181+
- Easy to lose your place
182+
- Interrupted your workflow
183+
184+
**With Prompt History Navigation**: Quickly access past prompts without leaving the keyboard.
185+
186+
### How it Works
187+
188+
The navigation is designed to be intuitive and adapt to your current context.
189+
190+
#### In an Active Conversation
191+
- **Arrow Up**: Shows the last prompt you sent. Keep pressing to go further back in the conversation.
192+
- **Arrow Down**: Moves forward through the conversation history, eventually returning to the text you were typing.
193+
194+
#### Starting a New Chat
195+
- **Arrow Up**: Shows the most recent prompt from your task history in the current workspace.
196+
- **Arrow Down**: Moves forward through your task history.
197+
198+
#### Edge Cases
199+
- If you start typing while navigating, the history is dismissed, and your new text is preserved.
200+
- Navigation only works when your cursor is on the first or last line of the input box to avoid interfering with multi-line editing.
201+
202+
### Configuration
203+
204+
This feature is enabled by default. There are no settings to configure.
205+
206+
### Benefits
207+
208+
- **Faster Workflow**: Reuse prompts without using the mouse.
209+
- **Better Context**: Easily access and build upon previous interactions.
210+
- **Less Interruption**: Stay focused on the task at hand.
211+
212+
### Common Questions
213+
214+
**"Why doesn't anything happen when I press the up arrow?"**
215+
- You might be in the middle of a multi-line prompt. The cursor must be on the first line.
216+
- There might be no history available for the current context.
217+
218+
**"What's the difference between conversation and task history?"**
219+
- **Conversation history** includes prompts from your current, active chat session.
220+
- **Task history** includes the initial prompts from all previous tasks in your current workspace.

0 commit comments

Comments
 (0)