Quick Start

Launch the TUI (no setup needed):

noodle

This opens an empty workspace in read-only mode. Initialize it from the command palette (Ctrl+P) or save your first request to bootstrap the collection directory.

To create a named collection, use noodle collection create:

noodle collection create my-api

This creates the directory, adds collection markers, and registers it. Open it and start sending:

noodle --collection ./my-api

You can have as many collections as you want, each with its own requests and environments. Use Ctrl+O to switch between them at runtime.

Press Ctrl+N to open the new request overlay. Enter a name, method, and URL, then press Ctrl+S to save.

Try it with a simple GET:

Name:       Example Request
Method:     GET
Request URL: https://httpbin.org/get

Press Ctrl+Return to send. The response pane shows the status code, headers, body, and timing.

What just happened?

Noodle wrote a .yml file on disk at ./collections/example-request.yml. Every request is a file: edit it directly, commit it to version control, or share it with your team.

Next Steps

• Add environment variables with $VARNAME syntax
• Configure authentication for your APIs
• Explore the keybindings reference