Skip to content

docs: document stdlib path override in Zed setup - #83

Merged
JesseHerrick merged 1 commit into
remoteoss:mainfrom
jamilabreu:docs/stdlib-detection-sourceless-installs
Aug 13, 2026
Merged

docs: document stdlib path override in Zed setup#83
JesseHerrick merged 1 commit into
remoteoss:mainfrom
jamilabreu:docs/stdlib-detection-sourceless-installs

Conversation

@jamilabreu

@jamilabreu jamilabreu commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Adds a short note to the Zed setup section covering the Dexter: could not detect Elixir stdlib... startup warning: how to point Dexter at a stdlib source tree via the stdlibPath initialization option (or DEXTER_ELIXIR_LIB_ROOT via lsp.dexter.binary.env).

Context: I hit this warning in Zed with a Homebrew-installed Elixir. Homebrew's elixir ships only compiled .beam files — no .ex sources (find $(brew --prefix elixir) -name "*.ex" comes back empty) — so auto-detection correctly rejects it (the elixir/lib/enum.ex check in internal/stdlib/stdlib.go), and pointing DEXTER_ELIXIR_LIB_ROOT at the Homebrew lib dir silences the warning without enabling stdlib navigation. What worked was a checkout of elixir-lang/elixir at the matching tag. Since the README's Zed section didn't mention either override, this documents them where Zed users will look.


Note

Low Risk
Documentation-only change with no runtime or configuration behavior changes.

Overview
Extends the Zed editor setup in the README with guidance for Dexter’s “could not detect Elixir stdlib” startup warning, especially when Elixir comes from Homebrew (no .ex stdlib sources).

The new section shows how to set stdlibPath under lsp.dexter.initialization_options, and notes the equivalent DEXTER_ELIXIR_LIB_ROOT override via lsp.dexter.binary.env, pointing users at a matching Elixir source tree (e.g. an elixir-lang/elixir checkout) for real stdlib navigation.

Reviewed by Cursor Bugbot for commit cbe2277. Bugbot is set up for automated code reviews on this repo. Configure here.

Elixir installed via Homebrew ships only compiled .beam files with no
.ex sources, so stdlib auto-detection has nothing to index and Zed
shows the 'could not detect Elixir stdlib' warning. Document how to
point Dexter at a matching Elixir source checkout from Zed settings,
via the stdlibPath initialization option or DEXTER_ELIXIR_LIB_ROOT.
@jamilabreu
jamilabreu force-pushed the docs/stdlib-detection-sourceless-installs branch from 5461de5 to cbe2277 Compare August 6, 2026 15:47
@jamilabreu jamilabreu changed the title docs: explain stdlib detection and source-less Elixir installs (Homebrew, distro packages) docs: document stdlib path override in Zed setup Aug 6, 2026

@JesseHerrick JesseHerrick left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks very much for the contribution @jamilabreu!

@JesseHerrick
JesseHerrick merged commit 3eaf504 into remoteoss:main Aug 13, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants