Installation
Get noodle on your machine in under a minute. Three ways, take your pick.
Quick install
Section titled “Quick install”curl -LsSf https://noodlerest.dev/install.sh | shDetects your OS and architecture, downloads the latest binary, and drops it
at ~/.local/bin/noodle.
If ~/.local/bin isn’t on your $PATH, the script will let you know: just
add this to your shell config (~/.zshrc, ~/.bashrc, etc.):
export PATH="$HOME/.local/bin:$PATH"Custom install location? Set NOODLE_INSTALL_DIR:
NOODLE_INSTALL_DIR=/usr/local/bin curl -LsSf ... | shNeed a specific version? Pin it with NOODLE_VERSION:
NOODLE_VERSION=v0.6.0 curl -LsSf https://noodlerest.dev/install.sh | shHomebrew
Section titled “Homebrew”brew tap wilfredinni/noodlebrew trust wilfredinni/noodlebrew install noodleFrom source
Section titled “From source”Requires Bun.
git clone https://github.com/wilfredinni/noodlecd noodlebun installbun run build:binThe binary lands at ./noodle. Move it somewhere on your $PATH.
Did it work?
Section titled “Did it work?”noodle --helpYou should see the CLI usage output. To launch the TUI:
noodleSupported platforms
Section titled “Supported platforms”Prebuilt binaries for these combos: others need to build from source.
| Platform | Architecture | Binary |
|---|---|---|
| macOS | arm64 | ✅ |
| Linux | x86_64 | ✅ |
| Linux | arm64 | ✅ |
Running an Intel Mac? Build from source above.
Updating
Section titled “Updating”noodle updateHomebrew installs run brew upgrade noodle. Standalone binaries read Noodle’s
update manifest, download the matching release, and verify its SHA-256 checksum
before replacement. Update checks cache release metadata for one hour; pass
--force to bypass that cache, or --json for scripted use.
The TUI performs the same check when it starts and installs an available update automatically. Progress appears in the header and beside the current version in About and Updates, which is available from the command palette.
AI Agent Skills
Section titled “AI Agent Skills”Install the noodle-use skill to teach your AI coding agent how to
create, organize, and audit noodle collections:
npx skills add wilfredinni/noodle --skill noodle-use -gAfter installing, ask your agent to scaffold a collection, audit your requests for security issues, or convert an Insomnia export.
