aws / aws/amazon-q-developer-cli

Path does not contain ~/.local/bin

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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.