hil-cli
The HIL command-line tool. Build, simulate, flash, and manage projects.
Usage
Run hil-cli --help to see all available commands.
hil-cli simulate
Run a LISP program headlessly, no hardware, no serial port, no simulator. The fastest way to test your code.
Options:
| Flag | Description |
|---|---|
-port none | Default. Headless mode, no serial port |
-fuzz N | Run N random iterations for stress testing |
hil-cli run
Run a LISP program interactively with the host serial monitor. Sends code to a real Arduino over serial.
Options:
| Flag | Description |
|---|---|
-port COM3 | Serial port to connect to |
-baud 115200 | Baud rate (default: 115200) |
hil-cli build
Transpile LISP to Arduino C and compile a .hex firmware artifact.
Options:
| Flag | Description |
|---|---|
-o output.hex | Output path for .hex file |
-board uno | Target board: uno, nano, mega |
hil-cli crumb
Generate a CRUMB circuit simulator project from LISP code. Transpiles to Arduino C and creates a .cru file.
Options:
| Flag | Description |
|---|---|
--open | Auto-open in CRUMB simulator |
-o file.cru | Output path for .cru file |
hil-cli init
Scaffold a new HIL project with directory structure, templates, and VS Code configuration.
Creates:
main.hil– starter programlib/– library directorytests/– test directory.vscode/– VS Code tasks and settings
hil-cli transpile
Convert LISP to Arduino C source code without compiling.
hil-cli lint
Check LISP source for common errors without running it.
hil-cli install-vscode
Install the HIL VS Code extension with syntax highlighting and snippets.
hil-cli ports
Scan and list available serial ports.
hil-cli firmware info
Show connected Arduino board information.
hil-cli firmware build
Compile TinyGo firmware for ATmega328P.
hil-cli firmware flash
Flash firmware to Arduino via avrdude.
Supports Arduino Uno, Nano, and Mega. Auto-detects board type and serial port.