Skip to content

What is Omega Lisp?

omega-lisp is the npm package whose source tree lives at projects/omega-lisp/. The published name is omega-lisp (package.json:2). It exposes a CLI bin (omega, also aliased omega-lisp) and a typed JavaScript API for embedding.

Package metadata (verbatim from package.json)

json
{
  "name": "omega-lisp",
  "version": "0.1.2",
  "description": "Omega — Lisp dialect with CESK evaluator, LLM oracle protocol, and session replay",
  "type": "module",
  "main": "./dist/src/index.js",
  "bin": {
    "omega": "./bin/omega.mjs",
    "omega-lisp": "./bin/omega.mjs"
  }
}

Public exports

projects/omega-lisp/package.json:8-33 declares six entry-point subpaths:

SubpathPurpose
omega-lispfull library API (OmegaRuntime, types, frame-IR, registry, REPL, sessions)
omega-lisp/piaiadapter to @mariozechner/pi-ai
omega-lisp/helpthe help-system functions used by REPL :help, :doc, :apropos
omega-lisp/runtimeruntime-provider used to instantiate runtimes from env
omega-lisp/frameirthe canonical IR (FrameValue, merkleHash, etc.)
omega-lisp/adaptersoracle adapters (OracleAdapter, OracleInit, capability types)

The src/index.ts re-exports the full surface; packages/core/src/index.ts is the narrow facade for Matrix-membrane consumers that don't want the REPL or driver registry.

Build pipeline

bash
# From projects/omega-lisp/
pnpm build           # build:packages → tsc → bundle (esbuild)
pnpm test            # vitest run
pnpm omega-fast      # CLI: node dist/omega-repl.mjs

The package is a workspace root (workspaces: ["packages/*"]). Sibling packages live under projects/omega-lisp/packages/ (core, repl, agents, oracle, solve, etc.).

Inference dependency

Omega depends on @open-matrix/inference (workspace) and the three first-party drivers:

json
"dependencies": {
  "@mariozechner/pi-ai": "^0.52.7",
  "@open-matrix/driver-anthropic": "workspace:*",
  "@open-matrix/driver-ollama":    "workspace:*",
  "@open-matrix/driver-openai":    "workspace:*",
  "@open-matrix/inference":        "workspace:*"
}

@anthropic-ai/sdk is a peer dependency, declared optional. The driver chooses what SDK is needed at runtime based on which adapter you instantiate.

Versions and lineage

The "0.1.2" version reflects the package's own evolution. The codebase is large and predates much of the Matrix Agent Platform; older docs in this tree (MEMORY.md etc.) refer to the project as "OmegaLLM," and the GitHub repository is github.com/hypnotranz/Omega. "Omega Lisp" is the docs/portal name; "OmegaLLM" is the historical / repo name.

See also

Source: projects/omega-lisp/package.json, projects/omega-lisp/src/index.ts:1-217, projects/omega-lisp/CLAUDE.md (project context).