Skip to content

AGENTS.md

Latest commit

 

History

History
48 lines (36 loc) · 1.93 KB

AGENTS.md

File metadata and controls

48 lines (36 loc) · 1.93 KB

ilo-lang — Agent context

ilo is a token-optimised programming language for AI agents.

What ilo is

Prefix-notation, strongly-typed, AI-agent-first language. Programs are small, verified before execution, and designed to minimise total token cost across generation + retries + context loading.

Key files

File Purpose
src/main.rs CLI entry point, import resolution, .env loading
src/lexer/mod.rs Tokeniser (logos)
src/parser/mod.rs Recursive-descent parser
src/ast/mod.rs AST types (Decl, Stmt, Expr, Type)
src/verify.rs Type verifier
src/interpreter/mod.rs Tree-walking interpreter
src/vm/mod.rs Register VM + bytecode compiler
src/codegen/ Python, explain, fmt, dense-wire emitters
src/tools/ MCP client, HTTP tool provider
examples/ Runnable example programs (also cargo test regression suite)
skills/ilo/ Agent Skill (Claude Code plugin + cross-platform installer)
npm/ npm package (WASM build + Node.js WASI shim for npx ilo-lang)
SPEC.md Full language specification
research/TODO.md Planned work

Running

ilo 'dbl x:n>n;*x 2' 5          # inline code
ilo program.ilo funcname args   # from file
cargo test                       # full test suite

Release process

  1. Bump version in Cargo.toml
  2. Commit + tag vX.Y.Z
  3. git push origin main --tags → triggers .github/workflows/release.yml → builds 5 native targets + WASM, publishes GitHub Release + npm package

WASM / npm

cargo build --target wasm32-wasip1 --release --no-default-features produces ilo.wasm (2.1MB). The npm/ directory wraps it in a Node.js WASI shim published as ilo-lang on npm. Requires NPM_TOKEN secret in GitHub repo settings.