Installation

Direct Download for Linux or Mac

Download the latest build for your computer architecture.
Put it in a $PATH directory so you can run it anywhere. You should rename the executable to ‘noodle’ for convenience. For example:

mv ~/Downloads/noodle-2025.alpha.5-amd64 ~/.local/bin/noodle

Make it executable.

chmod +x ~/.local/bin/noodle

Direct Download for Windows

Download the latest build for your computer architecture. Most likely you need the amd build if you’re using a normal laptop or desktop.

On Windows you’ll have to check your %PATH% in the command line or powershell.

echo %PATH%

You can place the noodle executable in one of the folders listed in the output. But it’s recommend to create a new one.

Make the new path, AKA the install folder.

# This is an example. You can choose where you want it.
mkdir "C:\Program Files\noodle\"

Add it to the environment variable.

# Use the chosen install path.
setx PATH "%PATH%;C:\Program Files\noodle\"

Verify it.

# Make sure the ouput has the install path.
echo %PATH%

Move the executable to the install path.

# Assumes you saved the latest noodle in 'YourUser\Downloads\'.
mv "%USER_PROFILE%\Downloads\noodle-2025.alpha.5-windows-amd.exe" "C:\Program Files\noodle\noodle.exe"

Go to a working directory and see if you can run noodle.

noodle --version

And there you go. You’re all set. See Getting Started to start noodling!

Build From Source with Git and Zig

You’ll need to install git and zig on your system somehow. These instructions are not platform specific.

Get the source code with git.

git clone --branch 2025.alpha.5 --single-branch --recurse-submodules git://franciscogg.site/noodle_cli.git noodle.git && cd noodle.git

Build and find the output at zig-out/bin/noodle.

zig build --release=safe

Install the binary found at zig-out/bin/noodle as with the direct dowmload.

cp zig-out/bin/noodle

You can also specify the output path in the build command directly.

# Linux example:
zig build --release=safe --prefix-exe-dir ~/.local/bin/

Build From Source with Git and CMake

You’ll need to install git and cmake on your system somehow. These instructions are not platform specific.

Get the source code with git.

git clone --branch 2025.alpha.5 --single-branch --recurse-submodules git://franciscogg.site/noodle_cli.git

Prepare the build directory.

cd noodle_cli/ && cmake .

Compile and install.

sudo make install