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, and escript on 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 serve creates the local selm database when [features] database includes postgres; trust auth on loopback; SCRAM / cleartext / MD5 also supported)
  • For SQLite: sqlite in [features] database, Hex esqlite in [dependencies], a C toolchain, and rebar3 (selm init --database=sqlite adds the feature and the dep)
  • Elixir: only if you use Elixir Hex packages or elixir externals
  • curl and unzip: 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' | bash

That 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 selm

Or from a clone into ~/.cargo/bin:

git clone https://github.com/nathanjohnson320/selm.git
cd selm
cargo install --path crates/selm_cli

To 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.