JetBrains / JetBrains/junie

README: Homebrew instructions point at `jetbrains-junie` tap and miss needed trust step

Open
#69 3 comments 1 reaction 0 assignees View on GitHub
Dominant language
Shell
Stars
437
Forks
32
Avg merge
4h 43m
Merged PRs (30d)
7

Description

Following the README's Homebrew instructions on macOS doesn't go smoothly right now, and some of it is the instructions themselves rather than the formula.

The README's **macOS (Homebrew)** block says:

```sh
brew tap jetbrains-junie/junie
brew install junie
```

but the docs site (https://junie.jetbrains.com/docs/junie-cli.html) says:
```sh
brew tap jetbrains/junie
brew update
brew install junie
```

On top of that, `github.com/jetbrains-junie` 404s, and `jetbrains-junie/homebrew-junie` only resolves via a GitHub redirect to `JetBrains/homebrew-junie`. So the README is pointing at an incorrect (legacy?) namespace that doesn't exist on its own.

Two issues when you actually follow the README:

1. Under Homebrew 6's tap-trust, tapping a third-party tap throws `Refusing to load formula ... from untrusted tap` and you have to `brew trust` it first, which isnt mentioned. Combined with the `jetbrains-junie` name and the 404 org, it's genuinely hard to tell at a glance whether you're looking at the real thing or a typosquat. I ended up confirming it by checking the commit author (TeamCity) and following the redirect before I trusted it.
2. The formula it installs is currently broken on Apple Silicon (see my issue JetBrains/homebrew-junie#2), so even after you get past the tap step it won't launch.

Also:

Leaning on that GitHub redirect staying alive is also a small namespace-takeover surface. Since `jetbrains-junie` seems like it isn't used anymore, the name could free up at some point (even if that means someone at JetBrains can't find a use for it and manually releases it), and if anyone re-registers it, `brew tap jetbrains-junie/junie` would resolve to whoever holds it. Pointing everything at the verified `jetbrains` org removes that dependency entirely.

### Suggested fix
Bring the README in line with the docs site:

```sh
brew tap jetbrains/junie
brew update
brew install junie
```

and maybe a one-liner noting that on Homebrew 6+ the first install will ask you to trust the tap (`brew trust jetbrains/junie`).

Happy to send this as a PR against the README if that's easier on your end.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.