Possibly undocumented: Proper way to use asdf in IDEs under macOS
- Dominant language
- Go
- Stars
- 25.6k
- Forks
- 941
- Avg merge
- 9h 24m
- Merged PRs (30d)
- 3
Description
### How can we improve the documentation?
What is the canonical way to use asdf with IDEs such as VS Code or JetBrains products under MacOS?
I have found out that putting `. "$(brew --prefix asdf)/libexec/asdf.sh"` in `.zprofile` (which makes total sense) is the fix to make tooling installed with asdf usable for the IDEs I use, but it seems to be undocumented.
Edit: I am aware of approaches such as [here](https://github.com/asdf-vm/asdf/issues/785#issuecomment-2645900454) but they do not leverage the asdf init script.
Edit 2: It seems that only VS Code is affected.
Contributor guide
Research direction
Start by reviewing the existing asdf initialization documentation and the .zprofile approach described in the issue, then compare the linked issue 785 guidance. Document the canonical macOS setup for VS Code, and clarify whether JetBrains products are affected or out of scope.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- macos, vscode, zsh
- Domain
- cli, developer-experience, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100