Home

Poste HTTP — File-Driven HTTP Request Executor for Neovim

Execute .http requests from Neovim — parse, send, render. No GUI, no bloat.

Quickstart

Installation

Lazy.nvim:

{
  "beyondlex/poste.nvim",
  dependencies = {
    "beyondlex/poste-http.nvim",
    -- optional: "beyondlex/poste-sql.nvim",
  },
  opts = {},
}

Requires the Rust CLI binary (poste). Install via:

:PosteUpdate

Your First Request

Create a .http file:

### Get Users
GET https://jsonplaceholder.typicode.com/users

### Create Post
POST https://jsonplaceholder.typicode.com/posts
Content-Type: application/json

{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

Place cursor on any request line and press <CR> (or :PosteRun). The response opens in a split buffer.

Key Commands

Key	Action
<CR>	Execute request at cursor
]] / [[	Jump next/prev request block
gd	Go to variable definition
gs	Show symbol outline
g?	Help window
q	Close response buffer

Documentation

Page	Contents
Syntax	Complete .http file format reference
Variables	@var definitions, {{var}} references, prompt variables, resolution
Scripts	Pre-request scripts, post-request assertions, API reference
Commands	All commands and key bindings
Configuration	Setup options
Import	OpenAPI/Swagger/Postman import
Completion	Completion system