nexus-tui

Crates.ionexus-tui
lib.rsnexus-tui
version0.2.1
created_at2025-12-13 21:20:03.748914+00
updated_at2025-12-27 20:38:59.898648+00
descriptionA terminal-based HTTP client for API testing
homepage
repositoryhttps://github.com/pranav-cs-1/nexus
max_upload_size
id1983404
size403,263
(pranav-cs-1)

documentation

README

Nexus

A terminal-based HTTP client for API testing built in Rust.

Nexus provides a keyboard-driven interface to help you manage and execute API calls efficiently. All your collections, requests, and configurations are automatically persisted using sled, an embedded database, so your work is saved between sessions.

Demo

Nexus Demo

Features

  • Full HTTP Method Support - GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
  • Request Organization - Group requests into collections for easy management
  • Response Viewer - View formatted responses with status codes and headers
  • Complete Request Editing - Edit URL, method, headers, query parameters, body, and authentication
  • Persistent Storage - All data automatically saved using sled embedded database
  • Keyboard-Driven - Vim-like navigation and shortcuts for maximum efficiency
  • Built-in Examples - Sample requests included to help you get started quickly
  • Import Support - Import Postman Collections (v2.1) with full support for authentication, headers, and nested folders
  • Export Support - Export collections as JSON or individual requests as curl commands

Installation

From crates.io

cargo install nexus-tui

From source

cargo install --path .

Usage

nexus

On first launch, you'll be greeted with a welcome screen that provides an overview and quick start guide. Press any key to dismiss it and start using Nexus. Check out the Example Collection to see sample requests demonstrating the various features.

Importing

Nexus supports importing Postman Collections (v2.1 format):

  • Import Collection: Press i to open the import dialog. Enter the path to your Postman collection JSON file (supports Tab autocomplete). Press Enter to import. The collection and all its requests will be added to Nexus with support for:
    • Nested folders (flattened with path prefixes)
    • All HTTP methods
    • Headers and query parameters
    • Request bodies (raw, urlencoded, formdata)
    • Authentication (Bearer, Basic, API Key)

Exporting

Nexus supports exporting your collections and requests:

  • Collection Export: Press o to open the export menu. Use arrow keys to select a collection, then press Enter to export it as JSON. The file will be saved in the exports/ directory with a timestamp.
  • curl Export: Press s to open the curl export menu. Use arrow keys to select a collection, press Enter, then select a specific request. The curl command is saved as a shell script in the exports/ directory and also copied to your clipboard.

Keyboard Shortcuts

Navigation:

  • Tab / Shift+Tab - Switch between panels
  • j / k or / - Navigate lists and move cursor
  • t - Switch editor tabs (Params, Headers, Body, Auth)

Actions:

  • Enter - Send the current request
  • e - Edit request (in Request Editor panel)
  • Esc - Save and exit edit mode
  • n - Create new request
  • d - Delete current request
  • y - Duplicate current request
  • c - Create new collection (in Collections panel)
  • x - Delete collection (in Collections panel)
  • i - Import Postman collection
  • o - Open collection export menu
  • s - Open curl export menu

Editing (when in edit mode):

  • Arrow keys - Navigate text fields
  • Tab - Switch between fields
  • + / - - Add/remove params or headers
  • Ctrl+U - Clear current field

Other:

  • ? - Toggle help screen
  • q / Ctrl+C - Quit

Building

cargo build --release

License

MIT

Commit count: 0

cargo fmt