Repository navigation
Getting Started
0x4171341 edited this page Jul 24, 2026
·
4 revisions
This page walks through installing L++, compiling a first program, creating a package project, and understanding which linker is used.
Linux/macOS:
curl -fsSL https://raw.githubusercontent.com/samarnever-droid/lplusplus/master/install.sh | sh
export PATH="$HOME/.lpp/bin:$PATH"
lpp --versionWindows PowerShell:
irm https://raw.githubusercontent.com/samarnever-droid/lplusplus/master/install.ps1 | iex
lpp --versiongit clone https://github.com/samarnever-droid/lplusplus.git
cd lplusplus
cargo build --release --bin lpp --bin lpp-link
./target/release/lpp --versionCreate hello.lpp:
def main():
print_str("Hello from L++!")
print(42)
Run:
lpp hello.lppOr from a source checkout:
./target/release/lpp hello.lpplpp --check hello.lppFor a directory of .lpp files:
lpp --checkalllpp new myapp
cd myapp
lpp build
lpp runTypical layout:
myapp/
lpp.toml
src/
main.lpp
tests/
lpp new <name> # create project
lpp init <name> # initialize current directory
lpp install # install dependencies
lpp add <name> # add dependency
lpp remove <name> # remove dependency
lpp update # refresh lockfile
lpp list # list dependencies
lpp tree # dependency tree
lpp metadata # package metadata
lpp outdated # unpinned dependencies
lpp clean # remove build output
lpp check # check package
lpp build # build native binary
lpp run # build and run
lpp test # run tests/L++ supports two linker paths:
| Linker | Command style | Use case |
|---|---|---|
| Direct linker | lpp-link |
zero external toolchain, small freestanding binaries |
| Host linker |
cc, clang, cl.exe
|
full libc/CRT compatibility |
Config is stored in ~/.lpp/config.json:
lpp config
lpp config set linker direct
lpp config set linker host
lpp config set linker autoPer-run override:
lpp --linker direct app.lpp
lpp --linker host app.lppRelease Linux binaries are intended to be static/musl-friendly so they work in small Alpine-like environments.
If the shell says lpp: not found after install:
- Check PATH:
echo "$PATH"
ls -l "$HOME/.lpp/bin"- Add L++ to PATH:
export PATH="$HOME/.lpp/bin:$PATH"- Confirm architecture:
uname -m
file "$HOME/.lpp/bin/lpp"