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.
What an Aleph file gives you
Section titled “What an Aleph file gives you”- 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
exlines thataleph checkruns. 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.
The parts
Section titled “The parts”| 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.