Home

Home is the main workspace. It combines the collections sidebar, the request top bar, request sections, command and search access, sending, and inline response inspection.

What you do here

• browse collections, folders, and requests
• create a new request with a
• open a request for editing
• edit Method and URL
• send requests
• inspect response body and headers
• search collections, folders, and requests
• rename, move, copy, import, and export from the command palette

Most common keys

Sidebar / normal mode

• j / k: move through sidebar rows
• J / K: jump between folders
• Ctrl+J / Ctrl+K: jump between collections
• h / l: cycle between pinned requests
• e: pin the selected request, or toggle a collection or folder
• a: create a new request
• s: send the active request
• c: close the active pinned request
• /: open Home search
• Ctrl+P: open the command palette
• Ctrl+O: open jump mode
• PageUp / PageDown: scroll the sidebar list faster
• Esc: collapse the selected collection or folder when possible

Top bar

Above the request sections, Home shows the active request method and URL.

• Ctrl+O, then 1: jump to Method
• Ctrl+O, then 2: jump to URL
• e / Enter: open the method picker when Method is selected
• Enter: save the URL when URL is being edited

Request sections

After you pin a request, you can move through the request sections.

• h / l: move between Info, Auth, Params, Headers, Body, and Settings
• e / Enter: open the selected section or row
• j / k: move within the current section when row selection is active
• s: send the active request
• v: open inline response selection
• Ctrl+U / Ctrl+D: scroll the inline response in request-editing contexts
• Esc: back out one level

Ctrl+O also lets you jump directly into these sections:

• q: Info
• w: Auth
• e: Params
• r: Headers
• t: Body
• y: Settings

Response selection

When response selection is open:

• h / l: switch between Body and Headers
• j / k: scroll the selected response
• e / Enter: open the full response viewer from Body
• Ctrl+U / Ctrl+D: scroll the inline response
• Esc: return to the request editor

Editing a request

Home editing is split into:

• Info
• Auth
• Params
• Headers
• Body
• Settings

Info

• j / k: choose Name or Description
• Enter: edit the selected field

Auth

• j / k: move through auth rows, starting with Type
• Enter: edit the selected row
• auth type and option rows use dropdown-style selection

Current auth support includes:

• No Auth
• Basic Auth
• Bearer Token
• API Key
• Cookie Auth
• Custom Header
• OAuth 2.0 client credentials

Params and Headers

• j / k: move through rows
• H / L: move between key and value
• a: add a row
• space: enable or disable the selected row
• d: delete a row
• Enter: edit the selected field

For Headers, piespector also shows inferred auto headers such as Accept, User-Agent, auth headers, and the default Content-Type. These can be toggled with space, but they are not edited like explicit rows. Explicit headers override inferred ones.

Body

Current body support includes:

• None
• Form-Data
• x-www-form-urlencoded
• Raw
• GraphQL
• Binary

Raw supports:

• Text
• JSON
• XML
• HTML
• JavaScript

Behavior by body type:

• row 1 is always Body Type
• Raw adds a Raw Format row before the preview or editor
• raw text-heavy bodies open a full text editor
• GraphQL uses its own editor path
• Binary uses an inline file path field with path completion
• form-style bodies use H / L, a, space, d, and Enter
• the preview pane syntax-highlights supported formats

Settings

Settings currently includes:

• Verify SSL
• Follow Redirects

Use space, e, or Enter to toggle the selected setting.

Common commands

Open the palette with Ctrl+P. The exact Home command list depends on the current Home context.

Home sidebar with no selection-specific action

• new
• new collection NAME
• import PATH
• export PATH
• history
• env

Request selected in the sidebar

• new
• new collection NAME
• new folder NAME
• import PATH
• export PATH
• edit
• rename NAME
• cp PATH
• mv PATH
• del
• history
• env

Folder selected in the sidebar

• new
• new collection NAME
• new folder NAME
• import PATH
• export PATH
• rename NAME
• cp PATH
• mv PATH
• del
• history
• env

Collection selected in the sidebar

• new
• new collection NAME
• new folder NAME
• import PATH
• export PATH
• rename NAME
• cp
• del
• history
• env

Inside request sections or response focus

• history
• env

Notes

• cp and mv are Home-only commands from sidebar context
• cp on a collection duplicates the selected collection in place
• exporting from Home writes the whole workspace unless a collection is selected
• importing on Home adds collections as new copies
• the command palette also includes Textual system commands such as Help

For full command behavior, see Command Palette. For auth details, see Authentication. For body details, see Request Bodies.