Commit 85f20fa
docs: improve install discoverability and recommend pipx/uv (#8)
## Summary
- Lead install instructions with `pipx`/`uv tool install` instead of
bare `pip` — avoids `externally-managed-environment` errors on modern
macOS/Linux
- Add explicit callout that `dremio-client` is an unrelated package
(LLMs were installing it instead of `dremio-cli`)
- Update PyPI description and keywords for better LLM/search
discoverability
## Context
A non-dev user asked Claude Code to "find the dremio CLI and install
it." Claude found `dremio-client` (wrong package), hit the
externally-managed-environment error, struggled with PATH, then hit
missing deps in the wrong package. None of these are bugs in
`dremio-cli`, but we can prevent the confusion with better docs and
metadata.
## Test plan
- [ ] Verify README renders correctly on GitHub
- [ ] Verify `pipx install dremio-cli` works on a clean macOS machine
- [ ] Check PyPI description after next release shows the updated text
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>1 parent aa34152 commit 85f20fa
2 files changed
Lines changed: 14 additions & 5 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
32 | 32 | | |
33 | 33 | | |
34 | 34 | | |
| 35 | + | |
| 36 | + | |
35 | 37 | | |
36 | | - | |
37 | | - | |
| 38 | + | |
| 39 | + | |
38 | 40 | | |
39 | | - | |
| 41 | + | |
40 | 42 | | |
41 | 43 | | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
42 | 47 | | |
43 | 48 | | |
44 | 49 | | |
| |||
48 | 53 | | |
49 | 54 | | |
50 | 55 | | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
51 | 60 | | |
52 | 61 | | |
53 | 62 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
| |||
17 | 17 | | |
18 | 18 | | |
19 | 19 | | |
20 | | - | |
| 20 | + | |
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
| |||
0 commit comments