CLI Reference

Command line interface for Ifá-Lang

Basic Commands

ifa run <file>

Execute an Ifá program file.

ifa run hello.ifa
ifa run examples/crypto.ifa --verbose
Option Description
--verbose, -v Show detailed execution info
--sandbox Run in sandboxed environment
-- <args> Pass arguments to the program

ifa repl

Start interactive REPL (Read-Eval-Print Loop).

ifa repl
>>> ayanmo x = 42;
>>> Irosu.fo(x * 2);
84

ifa check <file>

Type-check and lint a file without running it.

ifa check myprogram.ifa

ifa babalawo <file>

Run the Babalawo linter with proverb-based error messages.

ifa babalawo myprogram.ifa --strict

Build Commands

ifa compile <file>

Compile to bytecode.

ifa compile main.ifa -o main.ifab

ifa fmt <file>

Format source code.

ifa fmt src/*.ifa --check  # Check without modifying
ifa fmt src/*.ifa          # Format in place

Project Commands

ifa new <name>

Create a new Ifá project.

ifa new my-project
cd my-project
ifa run src/main.ifa

ifa test

Run tests in the current project.

ifa test
ifa test --filter crypto

Utility Commands

ifa --version

Show version information.

ifa --version
# Ifá-Lang v1.2.2

ifa --help

Show all available commands and options.

Environment Variables

Variable Description
IFA_DEBUG Enable debug output (1 = on)
IFA_SANDBOX Force sandbox mode (1 = on)
IFA_COLOR Force color output (auto, always, never)