Open-source terminal REST client

API workflows,
untangled.

v0.8.3The Workflow Comes Together

Write, send, inspect, and automate HTTP requests from readable files without leaving your terminal. Keep every collection versioned beside the code it exercises, ready for the TUI, CLI, scripts, and coding agents.

Install in one line
curl -LsSf https://noodlerest.dev/install.sh | sh

Explore the quick start
Noodle terminal interface showing a request collection, request editor, and response inspector

Fast by default

Stay in the terminal and keep your hands on the keyboard.

Made to review

Keep requests and environments readable beside your code.

Ready to automate

Use the same collection from the TUI, CLI, scripts, and agents.

01 · Files first

Requests that belong in the repository.

Every request is a readable YAML file. Edit it in Noodle or your editor, review it in Git, and keep it beside the code it exercises.

Request file reference
collections/users/get.ymltracked
name: Get user
method: GET
url: "$base_url/users/:id"
headers:
  Accept: application/json
params:
  id: 42
● valid requestplain YAML on disk
PUT/users/42200 OK87ms
BodyHeaders 12Cookies 2Timeline
{
  "id": 42,
  "name": "Ada Lovelace",
  "role": "developer"
}
application/json2.1 KB
02 · Full exchange

The whole exchange, without leaving the terminal.

Compose a request, send it, then move through body, headers, cookies, and timing from the same keyboard-first workspace.

Inspecting responses
03 · Environments

Environment-aware without leaking secrets.

Switch between development, staging, and production variables. Secret declarations stay in the file while values live in the OS credential vault or process environment.

Using environments
EnvironmentState
developmentactive
stagingready
productionready
API_TOKENOS credential vault
$noodle request run users/get --collection ./api
$noodle collection audit ./api
$noodle collection run ./api smoke/ health --env staging --json
$noodle agent install

status success · exit 0 · JSON available

04 · Automation

One collection, more than one way to work.

Explore interactively in the TUI, chain captured response values across ordered runs, enforce response assertions, or give coding agents the supported Noodle skill.

Automation guide
The complete workbench

The rest of the workflow is already here.

Focused enough to stay fast, complete enough to handle real API work.

Requests

URL, params, headers, body, and auth

Responses

Body, headers, cookies, status, timing, and assertions

Collections

Folders, inherited context, and Git-friendly files

Environments

Switchable variables and secure values

Transport

Proxy, TLS, mTLS, and authentication

Portability

Import OpenAPI, Swagger, Postman, and Insomnia. Export OpenAPI and Postman.

On the stove

Coming next

Planned directions, clearly separated from what Noodle ships today.

Roadmap · v0.9

Scripts and advanced tests

Add reusable setup, teardown, and deeper request checks.

Roadmap · v0.10

Richer CI reporting

Expand collection runs with reports such as JUnit.

Put your API workflow where it belongs.

Install Noodle and open your first collection.

curl -LsSf https://noodlerest.dev/install.sh | sh

Follow the quick start