Arkoi Language Guide

Arkoi is a systems language with a compact syntax, explicit typing, and a compiler-oriented workflow. This site is organized as a practical guide: start with the basics, then move into the language rules, examples, and CLI usage.

Read this first

1. Installation
2. Overview
3. Grammar
4. Language rules
5. Syntax reference
6. Functions
7. Types
8. Control flow
9. Examples
10. CLI usage

What Arkoi is

Arkoi centers on:

• Explicit function definitions
• Typed variables and typed parameters
• Primitive arithmetic and boolean expressions
• Structured control flow with if, else, while, and return
• A direct compile-to-native toolchain

What this guide covers

• How to build and run the compiler
• The grammar and language rules
• The current language shape and syntax rules
• The main type forms and expression rules
• The existing control-flow constructs
• Working examples that match the repository’s programs and tests

Scope

This guide documents the language. Features that are not part of the language are called out as future work instead of being described as supported behavior.