Run the first build

Updated Aug 05, 2026

Create an empty project directory and add a file named Netsukefile with the following complete manifest:

netsuke_version: "1.0.0"

targets:
  - name: hello.txt
    command: "echo 'Hello from Netsuke!' > hello.txt"

defaults:
  - hello.txt

Run Netsuke without a subcommand to build the manifest's defaults, then read the generated file:

netsuke
cat hello.txt

The second command prints Hello from Netsuke!.

If Netsuke cannot find Netsukefile, it reports the missing file and suggests --file. A different path can be selected with netsuke --file path/to/manifest.yml build.

The quick-start guide provides a longer walkthrough.