Skip to content

Commands

lex edited this page Jul 23, 2026 · 1 revision

Commands & Key Bindings

Commands

Command Description
:PosteRun Execute the request block at cursor
:PosteEnv [name] Show or switch to a named environment
:PostePasteCurl Parse curl command from clipboard → .http format
:PosteCopyAsCurl Copy current request as curl command
:PosteImportOpenAPI Import OpenAPI 3.x spec → .http files
:PosteImportSwagger Import Swagger 2.0 spec → .http files
:PosteImportPostman Import Postman Collection v2.1 → .http files
:PosteImportResolve Show import resolution status
:PosteHelp Show keymap help window
:PosteSymbols Show symbol outline (all requests)
:PosteOutline Toggle sidebar outline
:PosteFormatHttp Format .http buffer
:PosteHttpHistory Show request history
:PosteHttpBoundary Toggle ### block boundary indicator
:PosteUpdate Update Rust CLI binary (poste)
:PosteClearCache Clear response cache
:PosteCmpStatus Check completion status
:PosteCmpProfile Profile completion performance
:PosteInfo Show binary/version/completion info
:PosteCloseResult Close the current result buffer

Key Bindings

Source Buffer (.http)

Key Action
<CR> Execute request at cursor
]] Jump to next request block
[[ Jump to previous request block
gd Go to variable definition
grr Go to variable references
gs Show symbol outline
K Show variable value (hover)
<leader>rp Paste curl from clipboard
<leader>rc Copy request as curl
<leader>vv Pick environment
<leader>l Open request history
g? Show help window

Response Buffer

Key Action
q Close response buffer
B Switch to Body tab
R Switch to Request tab
E Switch to Headers/Verbose tab
A Switch to Assertions tab
S Switch to Script Log tab
<Tab> Cycle to next tab
<S-Tab> Cycle to previous tab
r Re-run the request
] Next response (when multiple)
[ Previous response (when multiple)
K Open image preview (if image response)
<leader>j Open jq filter prompt
<leader>jc Restore original JSON (clear jq filter)

Customizing Keymaps

require("poste").setup({
  keymaps = {
    source = {
      run = "<CR>",
      jump_next = "]]",
      jump_prev = "[[",
      goto_definition = "gd",
      goto_references = "grr",
      symbols = "gs",
      paste_curl = "<leader>rp",
      copy_curl = "<leader>rc",
      env_pick = "<leader>vv",
      history = "<leader>l",
      help = "g?",
    },
    response = {
      close = "q",
      view_body = "B",
      view_request = "R",
      view_verbose = "E",
      view_assertions = "A",
      view_script = "S",
      tab_next = "<Tab>",
      tab_prev = "<S-Tab>",
      rerun = "r",
      response_next = "]",
      response_prev = "[",
      image_preview = "K",
      jq_filter = "<leader>j",
      jq_restore = "<leader>jc",
    },
  },
})

Clone this wiki locally