AiLang Quickstart

How AiLang Is Different

AiLang is designed for humans and AI agents working in the same project. The project file describes the program, source is meant to be inspectable, and tool output should be deterministic enough for agents to reason about.

Install

macOS and Linux:

curl -fsSL https://ailang.codes/install.sh | sh

Windows PowerShell:

irm https://ailang.codes/install.ps1 | iex

Verify

ailang --version
aivm --help
aivectra --help

Create an Agent-Friendly Project

ailang init ./hello-ailang --template cli --agent codex
cd ./hello-ailang

The generated project gives both people and agents a clear manifest, source layout, and repeatable command path.

Start With an AI Coding Agent

The AiLang project is the same project regardless of the agent. The agent-specific part is the instruction file the agent reads from the project root.

ailang init ./hello-ailang --template cli --agents codex,claude
cd ./hello-ailang
ls AGENTS.md CLAUDE.md project.aiproj src/app.aos

Codex Project

Install the AiLang Codex skill so Codex knows the install, init, build, run, and publish workflow before the project exists. After the project is created, Codex uses the generated AGENTS.md.

git clone https://github.com/AiLangCore/ailang-codex-skill.git
cd ailang-codex-skill
./scripts/install.sh

Then tell Codex:

Use $ailang to create a new AiLang project named hello-codex and run it.

Claude Project

Claude-style workflows use CLAUDE.md. AiLang keeps AGENTS.md canonical and writes CLAUDE.md as the Claude-facing pointer.

ailang init ./hello-claude --agent claude
cd ./hello-claude
claude

Multi-Agent Project

Use --agents when a project should be ready for multiple agent tools. Supported values are codex, claude, cursor, gemini, copilot, and windsurf.

ailang init ./hello-agents --agents all

Inspect

find . -maxdepth 3 -type f | sort
cat project.aiproj

AiLang projects should be understandable from files on disk, without hidden IDE state or manual setup steps.

Add AiVectra

AiVectra is the vector UI package for AiLang. Adding it restores the library, package tool, and package templates into the project.

ailang package add aivectra
ailang package list
ailang template list projects
ailang template list files
ailang aivectra --help

Build

ailang build . --out ./build

Build output is intended to be stable and reviewable, so an agent can compare behavior before and after a change.

Run

ailang run .
aivm ./build/app.aibc1

AiLang compiles to AiBC bytecode. AiVM is the native C runtime that executes the compiled program.

Examples

Curated demo projects live in a separate examples repository so public walkthroughs are not mixed with compiler and VM regression fixtures.

git clone https://github.com/AiLangCore/ailang-examples.git
cd ailang-examples/examples/hello-cli
ailang build .
ailang run .

Next