Skip to content

Completion

Jump to bottom
lex edited this page Aug 6, 2026 · 2 revisions

Completion System

Poste HTTP provides context-aware completion for .http files via blink.cmp (primary) with nvim-cmp fallback.

Context Detection

The completion engine detects what you're typing based on cursor position and context:

Context When Suggestions
method Empty line at start of request HTTP methods (GET, POST, PUT...)
method_or_header Single word at start of line Methods + known header names
header_value After HeaderName: Context-appropriate values (e.g., Content-Type values)
variable Inside {{...}} All defined variables + namespace resolution
variable_namespace After Name. or Name.response. Dotted path completions
prompt_mapping Inside ` {name: ...}`
pre_script Inside < {% ... %} Script API keywords + Lua completions
post_script Inside > {% ... %} Assertion API + Lua completions
status_code After response.status = HTTP status code suggestions
import_path After import File path suggestions
import_alias After import path as keyword
run_target After run or client.run(" # + file paths
run_target_hash After run # or client.run("# All known request names
run_target_alias After run #alias. or client.run("#alias. Aliased request names
file_directive File-level area import, @, << keywords

Variable Completion

When typing {{, the completion popup shows:

  • File-level @var definitions
  • Block-level @var definitions
  • Environment variables from env.json
  • Magic variables ($timestamp, $uuid, $date, $randomInt)
  • Cross-request namespaces (after {{Name.)

Namespace Completion

After typing {{Name., you get:

Name.response.body.
Name.response.headers.
Name.request.body.
Name.request.headers.

Each further expansion shows available fields.

Script Completion

Inside < {% or > {% blocks, completion provides:

  • request. methods
  • client. methods
  • response. properties (assertions only)
  • md5. functions
  • env(), variables()
  • Standard Lua globals

Inside orchestration SCRIPT blocks (> {% %}), client. includes client.run, and the target string client.run("#alias. completes request names exactly like run #alias. — see Scripts.

Data Sources

Completion data is defined in lua/poste/http/data.lua:

  • HTTP methods
  • Request headers with expected values
  • MIME types
  • HTTP status codes
  • Script API documentation
  • Lua built-in members

Status & Debugging

:PosteCmpStatus   " Check if completion source is registered
:PosteCmpProfile  " Profile completion performance
:PosteInfo        " Show binary/version/completion info

Clone this wiki locally