NeoCLI

The NeoHaskell CLI tool.

Features

• Branded Developer Experience: Interactive TUI with the Neo mascot, spinners, and progress bars.
• Smart Scaffolding: neo new guides you through project creation with a full interview.
• Nix-Powered: Seamless integration with Nix flakes for reproducible builds.
• Watch Mode: neo build --watch, neo run --watch, and neo test --watch for instant feedback.
• Lock System: Prevent accidental modification of domain files with neo lock.
• Integrated Testing: Run both unit tests and Hurl integration tests with neo test.

Prerequisites

• Nix: Required for building and running projects. Install Nix.
• Git: Required for project initialization and the locking system.
• direnv (Optional): Recommended for automatic editor integration (HLS).

Installation

cargo install --path .

Usage

Create a new project

neo new

(Runs an interactive interview if no project name is provided)

Build the project

neo build

Run the project

neo run

Run tests

neo test

Watch mode

neo build --watch

Lock domain files

neo lock MyDomainFile

CI Mode

For headless environments, use the --ci flag to disable interactive prompts and animations:

neo build --ci

Testing

Fast unit + integration suite:

cargo test

Full end-to-end suite against the nix-built binary (requires nix build first and real network access):

cargo test --test e2e -- --ignored --test-threads=1

License

MIT