asdf-vm / asdf-vm/asdf

Possibly undocumented: Proper way to use asdf in IDEs under macOS

Open
#2,161 0 comments 0 reactions 0 assignees View on GitHub
documentation
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.