Nyxium Programming Language

A small stack- and register-based esolang implemented in TypeScript.

Try Nyxium Online

Language Reference • CLI Guide • REPL Guide • Examples

Overview

Nyxium is a compact symbolic esoteric programming language built around a simple execution model:

• six built-in registers (x y z a b c)
• a shared stack
• integer arithmetic
• structured loops and conditions
• character and numeric input/output

The goal of Nyxium is to stay minimal while still being expressive enough to write complete programs.

Example

x+++++

x{
    x.
    x-
}

Output:

5 4 3 2 1

Installation

Clone the repository and install dependencies:

git clone https://github.com/Pomid0rkaaa/nyxium.git
cd nyxium
npm install

Build the project:

npm run build

Link the CLI globally:

npm link

Verify the installation:

nyx --help

Note: Nyxium is not published to npm. You can also run the interpreter directly with node dist/nyxium.min.mjs.

Quick Start

Run a source file:

nyx examples/alphabet.nyx

Execute inline code:

nyx -c "x++++ x."

Start the interactive REPL:

nyx --repl

For all command-line options, see the CLI Guide.

Documentation

• Language Reference - complete language syntax and semantics.
• CLI Guide - command-line usage, options, and input handling.
• REPL Guide - interactive interpreter and REPL commands.
• Examples - complete example programs.

Development

Install dependencies:

npm install

Useful commands:

npm run dev         # Watch mode
npm run build       # Build the project
npm run test        # Run tests
npm run typecheck   # Type-check the project
npm run clean       # Remove the dist/ directory

Additional build targets:

npm run build:single   # Standalone single-file interpreter
npm run build:dev      # Compile TypeScript output
npm run build:web      # Browser playground

License

Nyxium is released under the MIT License.