Navigation & Modes

piespector is modal. The same key can mean different things depending on whether you are browsing a page, editing a field, choosing a dropdown value, using jump mode, or viewing a response.

The short version

• Ctrl+P opens the command palette
• / opens search on Home and History
• Ctrl+O opens jump mode on Home
• Esc exits the current interaction mode when that mode supports leaving
• j / k usually move vertically
• h / l usually move horizontally
• e or Enter usually opens or edits the selected thing
• s sends the active request on Home

Command palette

Use the command palette for page actions, imports, exports, tab switches, replay, renames, moves, and system commands such as Help.

• Ctrl+P opens the palette
• Tab accepts the highlighted completion
• Enter runs the selected command
• Esc closes the palette

Examples:

rename "Books API v2"
import "My Collections.json"
mv "Target / Auth Folder"

Older : prefixes are still parsed if pasted, but the current UI opens commands through Ctrl+P.

See Command Palette for the full reference.

Search mode

Search is available on Home and History.

• / opens the search palette
• type to narrow matches
• Enter opens the highlighted result
• Esc closes the palette

On Home, search opens matching collections, folders, or requests.

On History, search jumps to matching history entries.

Jump mode

Jump mode is Home-only and is the fastest way to move between the sidebar, top bar, request sections, and response tabs.

• Ctrl+O enters jump mode
• Tab jumps to the collections sidebar
• 1 jumps to Method
• 2 jumps to URL
• q / w / e / r / t / y jump to Info, Auth, Params, Headers, Body, and Settings
• a / s jump to response Body and Headers
• Esc cancels jump mode

Inline edit mode

Many fields use a one-line editor instead of a separate screen.

• type to edit the current value
• Enter saves
• Esc cancels
• Tab completes placeholders in URL and text inputs
• Ctrl+V pastes

Inline editors also support:

• filesystem path completion for Binary body paths
• direct toggling for non-text fields such as Sensitive, Verify SSL, and Follow Redirects

Text editors

Text-heavy request bodies open in a dedicated text area.

• Ctrl+S saves
• Esc cancels
• Tab completes placeholders

This is used for raw text bodies and GraphQL.

Response viewer

Both Home and History can open a response viewer for body content.

• Esc closes the viewer
• copy uses platform-specific shortcuts
• on macOS, copy is Ctrl+C
• on Linux, copy is Ctrl+Shift+C
• on Windows, copy is Ctrl+Shift+C or Ctrl+Insert

Help

Current builds use Textual’s help panel instead of an app-specific :help command.

• Open Ctrl+P
• run the system Help command
• repeat it to hide the panel

Where to go next

For page-specific movement, use the page guides:

• Home
• Env
• History