Lish

Manifesto Why Lish Design Lexicon Case Study GitHub

Code as Literature.

Lish is the first programming language designed to be read like a story and written like a letter. We believe that syntax should not be an obstruction to thought, but an elegant carriage for logic.

Begin the Narrative Read the Lexicon

Natural Syntax

Code that reads exactly as English. Eliminate the cognitive load of deciphering symbols; let the logic speak for itself.

Logical Flow

Structured like a well-reasoned essay. Functions are chapters, variables are subjects, and execution is the narrative arc.

The Author's Compiler

A compiler that acts as an editor, suggesting structural improvements and enforcing clarity rather than just catching syntax errors.

EXAMPLEaverage.lish

to find the average of numbers,
    let the sum be zero,
    for each number in numbers
        add the number to the sum,
    then return the sum divided by the count of numbers.

Folio 1

// Why Lish?

A New Era of General-Purpose Design

Lish was built because modern developers shouldn't have to choose between cognitive comfort and execution speed. Here is how Lish stacks up against standard general-purpose languages.

Intuitive Syntax

No cryptic symbols, semicolons, or nested parentheses. Lish reads like plain English instructions, making the code self-documenting.

// Lish:

repeat 3 times

// Python/JS:

for (let i = 0; i < 3; i++)

Zero-Cost Abstractions

High-level structures like entities and component systems map directly to contiguous memory arrays and flat offsets at build time.

// Lish:

entity Player

// OOP Languages:

class Player & heap pointers

Elegant Simplicity

No heavy runtimes, no complex package config. A clean, single-binary compiler toolchain that gets out of your way and runs anywhere.

// Dependencies:

Zero Runtime / VM

// Compiles to:

Standalone direct machine binary

Native Machine Speed

Compiles directly to zero-overhead x64 machine code with advanced CPU register mapping and vector optimizations.

// Engine:

Raw x64 registers

// Execution:

Nanosecond scale operations

// Interactive Site Snapshots

The Aesthetic Design Canvas

Here are the original, visually stunning, high-fidelity design concepts for the Lish homepage and Lexicon reference.

lish-lang.org/home

Design Concept: Home & Manifesto

lish-lang.org/lexicon

Design Concept: Syntax of Intent

Technical Lexicon Specification

Lish Specifications

1. Basics

Declaring variables, console printing, and basic arithmetic. Types are inferred automatically.

The Lish (Intent)

// Hello World
say "Hello World"

// Variables & Inference
let name be "Alex"
let age be 25

say name
say age

// Math & Operations
let a be 10
let b be 20
let result be a + b
say result

The Metal (Machine Assembly)

Lish allocates string literals to the read-only data segment (.rodata). Variables 'name' and 'age' are stored in registers or stack-frame offsets. Under optimization modes, Lish maps 'age' directly to R8D and 'name' to R9. The expression 'a + b' compiles to a single, zero-overhead ADD machine instruction: mov eax, 10 add eax, 20 mov [result], eax No garbage collector. No heap allocation. Just registers.

Compiler action: direct zero-overhead x64 compiler mapSyntactic Model: plain English logic

Raw Metal Compiler CLI

lishc compiler console

[compiling source...]