clox/README.md

clox — Crafting Interpreters (clox, C)

A tiny bytecode VM + compiler for the Lox language, built while following Crafting Interpreters. This is a personal learning project.

Crafting Interpreters: https://craftinginterpreters.com/

Build

Requires a C99 compiler (tested with clang on macOS). Uses the provided Makefile.

# Build the executable to bin/clox
make

# Clean build artifacts
make clean

# Show discovered sources/objects (diagnostic)
make debug

# (Optional) regenerate compile_commands.json for clangd/etc.
make bear

Usage

Run a file

clox [file]

Run Repl

clox

Layout

include/   # headers (.h files)
src/       # source (.c files)
obj/       # build objects (generated)
bin/       # executable output (generated)