Agent and Contributor Docs

Build procedures, migration notes, and deterministic agent workflows.

Codex Skill

The Codex skill teaches Codex how to install AiLang, create an agent-ready project, and run the standard build/publish checks.

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

Use it in Codex:

Use $ailang to create a new AiLang project named MyApp and run it.

Contributor Paths

Core development uses separate repositories. Clone them as siblings so repo-local scripts can find the installed SDK, package registry, and source checkouts consistently.

mkdir AiLangCore
cd AiLangCore
git clone https://github.com/AiLangCore/AiLang.git
git clone https://github.com/AiLangCore/AiVM.git
git clone https://github.com/AiLangCore/AiVectra.git
git clone https://github.com/AiLangCore/ailang-packages.git
git clone https://github.com/AiLangCore/ailang-core-packages.git
git clone https://github.com/AiLangCore/ailang-examples.git

git -C AiLang checkout develop
git -C AiVM checkout develop
git -C AiVectra checkout develop

Repository Verification

Run each verification command from the workspace root. Keep the generated build outputs uncommitted.

(cd AiLang && ./test.sh)
(cd AiVM && ./test-aivm-c.sh)
(cd AiVectra && ./scripts/test-all.sh)
(cd ailang-examples && ./scripts/validate-examples.sh)

Host screenshot parity is optional because it needs local GUI permissions and a screenshot helper.

cd AiVectra
AIVECTRA_SCREENSHOT_TEST=1 \
AIVECTRA_SCREENSHOT_TOOL=/path/to/take_screenshot.py \
./scripts/test-all.sh