Noodle CLI
A terminal REST client with YAML collections next to the code and a skill that lets the agent write and run requests itself
- 402 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The agent sends HTTP requests to your services with keys from environments, and sent actions cannot be undone.
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/noodle-rest-noodleDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent sends HTTP requests to your services with keys from environments, and sent actions cannot be undone.
This is third-party code. Review the repository files before installing.
What it does
Noodle keeps HTTP requests in YAML files inside the repository, so a collection is versioned in Git with the code it exercises. Environments live in dotenv files, and secrets go to the OS vault. A collection is used from the text UI, the command line, CI and through an agent. The `noodle agent install` command installs the noodle-use skill. With it the agent creates and edits collections, imports OpenAPI, Swagger, Postman and Insomnia, runs requests and folders non-interactively and reads JSON results. Built in are response checks on status, timing, headers and JSON values, JSON Schema tests, passing values between requests and sandboxed JavaScript scripts. A collection run saves a JSON or JUnit report, and GitHub Actions has a ready `setup-noodle` action.
Who it is for. Backend developers and API testers who live in the terminal and want requests in Git instead of a cloud Postman.
Good fit when
- A Postman collection is outdated and drifts from the code, and you want it in the repository next to the service.
- The agent added an endpoint, and it should be checked right away with a request asserting status and fields.
- CI needs a run of API requests with a JUnit report on every pull request.
- A login and logout scenario has to wrap each test run over CSV rows.
Not a fit when
- The team needs a graphical client with a shared cloud workspace.
- You need a load test: the Noodle runner goes through collection requests in order.
- Work happens on Windows where unsigned programs cannot run.
Example request
Import openapi.yaml into a Noodle collection, add a status 200 check to every GET and run the users folder with a report in results.json.Limitations
Prebuilt binaries exist for macOS and Linux (glibc) on arm64 and x86_64, and the Windows x64 build is in beta. Windows executables are unsigned, and the Defender report for v0.10.1 remains open. After a Homebrew upgrade the skill must be refreshed with `noodle agent install`. Importing Postman or Insomnia scripts and tests requires a new collection, and foreign APIs in those scripts are not translated.
How to disable. Run `brew uninstall noodle` or delete the binary installed by the script. Remove the noodle-use skill from the agent's skills folder.
FAQ
How do I connect Noodle to an agent?
Run `noodle agent install`. It installs a skill with which the agent creates, edits and runs collections through the CLI and YAML files.
Can I move a collection from Postman?
Yes, Noodle imports Postman, Insomnia, OpenAPI and Swagger and exports to OpenAPI and Postman. Compatible Postman and Insomnia scripts are kept without translation.
How do I run Noodle in GitHub Actions?
Use the `noodle-rest/setup-noodle@v1` action with an exact CLI version. It verifies the binary's SHA-256 and adds it to PATH, and the report is written with `--reporter junit --output results.xml`.
Where are secrets stored?
Environment variables live in dotenv files, and Noodle puts secrets in the OS vault. Values from responses can be saved to an environment or a secret for later requests.
Which auth methods are supported?
Bearer tokens, basic, API keys, OAuth 1.0a, OAuth 2.0, NTLMv2 and AWS SigV4. Proxies and TLS support custom certificate authorities and mutual TLS.
Discussion
No questions or reviews yet.
Related
CLI toolsAn MCP server and plugin for agents that generate web APIs from OpenAPI, AsyncAPI, GraphQL, gRPC and SQL specs on a Rust core.
Official skills and agents from the .NET team: performance, MSBuild, NuGet, upgrades, testing, ASP.NET Core, Blazor and MAUI
Hundreds of per-provider skills teach an agent to receive webhooks, verify signatures and handle events, with code examples.
EasyYapi exports APIs from Java and Kotlin code to YApi, Postman and OpenAPI, and its skill helps agents write export rules.
Sixteen Spring Boot skills: the agent explores the application first, then edits JPA, DTOs, REST, Security, Kafka and tests.
A Frappe command line for agents: reads ERP documents and reports, runs read-only SQL and keeps profiles with no write rights
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Noodle (this card) | no | 402 | |
| Hurl | no | 19,337 | requests in a plain text format for CLI and CI; here also a terminal UI, Postman import and an agent skill |
| Posting | no | 12,623 | also keeps requests in YAML, with the agent working through the open UI; here the agent runs sets from the CLI via a skill and writes JUnit reports |
README in short
The README covers installing through Homebrew, a script and PowerShell, a GitHub Actions example and a long feature list linking to guides. At the end there are developer notes for Bun and OpenTUI.