| title | arc CLI | |
|---|---|---|
| description | arc v1 compiler commands — build, run, check, init, direct file mode, and flags | |
| tags |
|
|
| date | 2026-05-22 |
arc is the Arimo v1 compiler and project tool.
Compile the current project using arc.toml:
arc build # compile project using arc.toml
arc build must be run from a directory containing arc.toml. The entry file comes from [project].entry; if missing, Main.arm is used.
Pass one .arm file directly without a subcommand:
arc Main.arm # compile single file
Imports are discovered from the entry file. Direct multi-file command arguments are not part of the v1 CLI surface.
Compile and immediately execute:
arc run # compile + run using arc.toml entry point
Type-check without producing an executable:
arc check # type-check only using arc.toml entry point
BorrowChecker is planned for a later v1 iteration; arc check currently runs parser and type-checker validation.
Initialize a new Arimo project in the current directory:
arc init myapp # creates myapp/ with arc.toml and Main.arm
Generated arc.toml:
[project]
name = "myapp"
version = "0.1.0"
entry = "Main.arm"The v1 compiler auto-detects the host platform — ELF on Linux, PE on Windows. Use --target linux|windows to override:
Generated Main.arm:
package myapp;
public class Main {
public static main() : Void {
IO.println("Hello, Arimo!");
}
}
The current v1 generator writes public class Main in the scaffolded file.
| Flag | Command | Effect |
|---|---|---|
--stdlib-path <dir> |
all | Override stdlib directory |
| `--target linux | windows` | all compile modes |
--check |
direct file mode | Type-check only |
arc looks for stdlib/ in the same directory as arc.exe. Override with --stdlib-path:
arc --stdlib-path C:/arimo/stdlib Main.arm
arc build --stdlib-path C:/arimo/stdlib
The v1 CLI banner is arc v1.0.
- arc-toml — project configuration
- installation — installing arc
- hello-world — first program