restui

A TUI HTTP client. Run HTTP requests from your terminal with vim keybindings.

Features

• Vim-like keybindings (normal, insert, visual modes)
• Collections from .http files
• Request chaining with {{@request_name.json.path}} syntax
• Environment variables support
• Syntax-highlighted JSON responses
• Theme support
• Request history
• Cookie management
• Neovim integration via restui.nvim

Installation

From source

git clone https://github.com/Di3go0-0/restui.git
cd restui
cargo install --path .

This installs the restui binary to ~/.cargo/bin/. Make sure it's in your PATH:

# Add to your shell config (~/.bashrc, ~/.zshrc, etc.)
export PATH="$HOME/.cargo/bin:$PATH"

Requirements

• Rust 1.75+
• wl-copy (Wayland) or xclip (X11) for clipboard support

Usage

# Open in current directory (scans for .http files)
restui

# Open a specific file
restui --file api.http

# Specify working directory
restui --dir ./my-project

# Use an environment file
restui --env-file env.json

Keybindings

Global

Vim Modes (Body / Request fields)

Request Panel

Collections

.http File Format

# @name Get Users
GET https://api.example.com/users
Authorization: Bearer {{token}}

###

# @name Create User
POST https://api.example.com/users
Content-Type: application/json

{
  "name": "John",
  "email": "john@example.com"
}

Environment Variables

Use {{variable_name}} syntax to inject values from the active environment into your requests.

Environment file

Create an env.json (or env.yaml) in your .http/ folder or project root:

{
  "dev": {
    "base_url": "http://localhost:3000",
    "token": "dev-token-123"
  },
  "prod": {
    "base_url": "https://api.example.com",
    "token": "prod-token-456"
  }
}

Supported filenames (auto-discovered): env.json, env.yaml, env.yml, .env.json, environments.json, environments.yaml. You can also pass a file explicitly with --env-file.

Using variables

Reference variables in any request field (URL, headers, body, params, cookies):

# @name Get Users
GET {{base_url}}/api/users
Authorization: Bearer {{token}}

Keybindings

Autocomplete is available — type {{ in any field to see matching variables from the active environment.

Request Chaining

Use {{@request_name.json.path}} to extract values from a previous request's JSON response.

# @name login
POST {{base_url}}/auth/login
Content-Type: application/json

{"email": "user@test.com", "password": "secret"}

###

# @name Get Profile
GET {{base_url}}/api/profile
Authorization: Bearer {{@login.token}}

Syntax

The referenced request must be executed first so its response is cached. Autocomplete activates automatically when you type {{@ — it suggests request names and then available JSON fields.

Neovim Integration

Use restui.nvim to open restui in a floating terminal inside Neovim:

-- lazy.nvim
{
    "Di3go0-0/restui.nvim",
    config = function()
        require("restui").setup()
    end,
    keys = {
        { "<leader>rr", "<cmd>Restui<cr>", desc = "Toggle restui" },
    },
}

License

MIT