Skip to content

Introduction

Aleph is a programming language whose primary authors and readers are AI agents. Its goals are few tokens, native speed, correctness on the first attempt and safety by default. Human readability is not a goal of the source text: people read the summary that aleph explain generates.

  • Declared capabilities. A program states what it may touch (use fs.read "data"). Everything else is denied, at compile time when the path is known and at run time when it is computed.
  • Examples as tests. Every function carries ex lines that aleph check runs. A function without examples does not compile.
  • Diagnostics for machines. Errors are JSON objects with a code, the exact AST node and, when it is certain, the fix.
  • One canonical form. The formatter accepts one spelling per program, so two agents writing the same function write the same file.
  • Two ways to run. An interpreter and a native backend through C, with byte-identical output.
Name What it is
Aleph The language and its compiler, aleph
Tlön The runtime: memory, builtins, capability checks and traps
Uqbar The registry of verified definitions, by hash (planned)
Orbis The pipeline that generates a corpus of verified programs (planned)
  • Getting started: install the compiler and run a first program.
  • For agents: how to give an agent the whole language in under 2,000 tokens.