Install
The repo is private. Release archives stay private with it. Once selm is on your PATH, you can init projects from anywhere.
Prerequisites
You will need these tools on your machine:
- Erlang/OTP 29:
erl,erlc, andescripton PATH for the Erlang target - GitHub CLI (
gh) authenticated to this repo: for private release downloads - Rust (stable): only if you build the CLI from source instead of a release archive
- PostgreSQL on
127.0.0.1:5432: for Postgres apps such as the todo example (selm servecreates the localselmdatabase when[features] databaseincludespostgres; trust auth on loopback; SCRAM / cleartext / MD5 also supported) - For SQLite:
sqlitein[features] database, Hexesqlitein[dependencies], a C toolchain, andrebar3(selm init --database=sqliteadds the feature and the dep) - Elixir: only if you use Elixir Hex packages or
elixirexternals curlandunzip: for package downloads
Private release binary
Tagged releases publish selm and selm-lsp plus JS share data. No git clone required. The helper script is scripts/install-cli.sh:
gh api repos/nathanjohnson320/selm/contents/scripts/install-cli.sh \
-H 'Accept: application/vnd.github.raw' | bashThat installs into ~/.local/bin and ~/.local/share/selm (PREFIX=... to change). Keep ~/.local/bin on your PATH. Targets: linux-x64, darwin-arm64, darwin-x64, and a win32-x64 zip on the release page.
Or pick one asset with gh release download (pattern selm-cli, target linux-x64).
Install with Cargo
From Git without keeping a working tree:
cargo install --git https://github.com/nathanjohnson320/selm.git --locked --bin selmOr from a clone into ~/.cargo/bin:
git clone https://github.com/nathanjohnson320/selm.git
cd selm
cargo install --path crates/selm_cliTo update a path install later, pull and run the same cargo install command again.
Building from a checkout
While hacking on the compiler itself, you can run the debug binary without installing:
cargo build -p selm --bin selm
# debug binary: target/debug/selm
cargo run -p selm --bin selm -- <command>The language server is separate: cargo install --path crates/selm_lsp (or cargo build -p selm_lsp). Agent diagnostics MCP is cargo install --path crates/selm_mcp (or cargo build -p selm_mcp); see AI and editors/mcp. Release archives already include selm-lsp next to selm.