# HIL-OS Documentation

Documentation for every part of the HIL-OS V9.5 toolchain.

## Index

| Document | Covers |
|----------|--------|
| [ARCHITECTURE.md](ARCHITECTURE.md) | System layout, processes, data flow |
| [HIL-LISP-REFERENCE.md](HIL-LISP-REFERENCE.md) | The HIL LISP dialect: ops, macros, examples |
| [CLI.md](CLI.md) | `hil-cli` package-manager command reference |
| [PROTOCOL.md](PROTOCOL.md) | Serial wire protocol + headless IPC protocol |
| [NODE-API.md](NODE-API.md) | Node.js wrapper (`hil-node/hil.js`) |
| [FIRMWARE.md](FIRMWARE.md) | Blinky node firmware (TinyGo, ATmega) |
| [CRUMB-SIMULATION.md](CRUMB-SIMULATION.md) | Transpiling LISP to the CRUMB circuit simulator |
| [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | Common problems and fixes |
| [DEPLOYMENT.md](DEPLOYMENT.md) | Deployment, portability, and language ports |

## Toolchain health check

```powershell
hil-cli doctor
```

Verifies the Go toolchain, Node.js, the monitor executable, the Node wrapper,
the CRUMB installation, and runs self-tests for the LISP→C transpiler and the
`.cru` generator.
