aws / aws/amazon-q-developer-cli
Path does not contain ~/.local/bin
- Dominant language
- Rust
- Stars
- 2k
- Forks
- 439
- PR merge metrics
- No merged PRs in 30d
Description
### Checks
- [x] I have searched [github.com/aws/amazon-q-developer-cli/issues](https://github.com/aws/amazon-q-developer-cli/issues?q=) and there are no duplicates of my issue
### Operating system
macOS 15.5.0 (24F74)
### Expected behaviour
# Overview
`q doctor` outputs the following error message after installing the Q CLI:
```
✘ PATH contains ~/.local/bin: Path does not contain ~/.local/bin
✘ Doctor found errors. Please fix them and try again.
If you are not sure how to fix it, please open an issue with q issue to let us know!
```
## Workaround
The path can be modified manually in zsh with this command:
```
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc; source ~/.zshrc
```
Followed by restarting the shell manually or with this command:
```
exec zsh -l
```
### Actual behaviour
Q Doctor reports that the required path value is not found. However, it doesn't help the user resolve this issue in any of the following ways:
- Update the path itself automatically
- Point to relevant documentation that explains how to update the path
- Telling the user what commands they could use to address the problem
I'm not sure what the preferable approach is given the tool's scope, but one or more of these would likely be an improved user experience.
### Steps to reproduce
Running `q doctor` without setting the required PATH variable first (and restarting the terminal).
Contributor guide
Assessment
This issue has not been assessed yet.