Readable requests. Versioned workflows. No lock-in.

Write, send, and inspect HTTP requests from YAML files in your repository. Noodle stays local, works with Git, and belongs in your terminal.

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

Open sourcemacOS & LinuxVerify install

Quick StartRead the docs
Noodle TUI WorkspaceNoodle default theme Catppuccin
# collections/get_with_params.yml
name: Get with Params
method: GET
url: $base_url/posts
headers:
  Content-Type: Application/Json
params:
  - name: userId
    value: $user_id
auth:
  type: bearer
  token: $token
# noodle is for you

Your requests are stored locally as simple YAML files, easy to read, easy to version control.

No heavy databases, no cloud synchronization lock-in, and no proprietary formats.

The workflow

Write it. Version it. Run it.

Noodle keeps the request itself, its shared configuration, and its repeatable checks in files your team can review and run anywhere.

Requests

Compose a real request

Define the URL, headers, params, body, and auth in one readable request file—then send it without leaving the terminal.

Send with Ctrl+Enter/J
Shared context

Keep context beside code

Share auth and headers through folders, switch environments, and review every request as plain YAML in Git.

Edit a folder to add Auth
Automation

Run and audit with confidence

Use the CLI in scripts or agent workflows, inspect response history, and audit collections before you share or ship them.

$ noodle collection run .
# example prompts
> Scaffold Stripe API collection
> Audit my collection for security
> Convert Insomnia export to Noodle
> Set up basic auth on Posts folder
> Change expand layout keybinding to Alt+I
> Set Catppuccin as my theme
> How many requests are in the Stripe collection?
> What's the average login response time?
> Sort folders from Z to A
> Add a GET request for user profiles
> Update variables in development env
# ai agent skill

Supercharge your AI coding assistants.

Add Noodle to your agent's toolkit. Enable AI assistants to scaffold, edit, and audit collections natively.

npx skills add wilfredinni/noodle --skill noodle-use -g

Also included

The rest of the workflow, covered.

Import what you already have

Import OpenAPI, Swagger, Postman, and Insomnia sources, then export portable OpenAPI or Postman collections.

Revisit every response

Keep a per-request timeline to compare, inspect, and replay the work that got you here.

Make the terminal yours

Choose from 30+ built-in themes and adapt Noodle to the space where you do your best work.

Keep your API workflow in files you own.

Noodle is free, open-source, and runs entirely in your terminal. Start with a readable request, then keep every change reviewable in Git.

Install NoodleRead the docs