Getting Started

CLI

Run, compile, and explore Plain Language projects from the command line.

CLI focus

  • Run .pln files quickly.
  • Compile to Python outputs.
  • Inspect the transpiled code.

Core commands

The CLI is designed to cover the full lifecycle: run, compile, and inspect your programs.

plain run file.pln
Transpile and execute the file in one step.
plain run --verbose file.pln
Print the generated Python before execution.
plain compile file.pln
Write a .py file next to your source.
plain repl
Start an interactive REPL session.

Verbose mode

Use verbose mode when you want to inspect how each line transpiles to Python.

terminal
plain run --verbose src/app.pln

REPL workflow

The REPL is great for exploring syntax, testing statements, and iterating on ideas quickly.

terminal
plain repl
print "Testing"
create a list named items with [1, 2, 3]