aws / aws/amazon-q-developer-cli

Path does not contain ~/.local/bin

Aperta
#2,118 0 commenti 2 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
Rust
Stelle
2k
Fork
439
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

### 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).

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Start by running `q doctor` without ~/.local/bin in PATH and review how it reports the PATH check. Compare the reported failure with the workaround using ~/.zshrc and `exec zsh -l`. Done means the doctor output gives users a clear, actionable way to resolve the missing path, whether through commands or relevant documentation.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
rust, zsh
Ambito
cli, developer-experience
Tipo di issue
Funzionalità
Difficoltà
4/5
Tempo stimato
3-5 giorni
Stato di attività
Ferma
Chiarezza
Abbastanza chiara
Idoneità per principianti
35/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.