macOS: after `uv tool install graphifyy`, only `uv tool run --from graphifyy graphify install` works

[Patsch36]

Summary

On macOS, after installing with uv tool install graphifyy, the only reliably working invocation is:

uv tool run --from graphifyy graphify install

Direct command usage (graphify install) fails with command not found, and uv tool run graphify ... fails because uv tries to resolve graphify as a package name.

Environment

• OS: macOS (zsh)
• Tooling: uv

Steps to Reproduce

1. Install the tool package:

   uv tool install graphifyy

2. Try running the CLI directly:

   graphify install

3. Try running via uv tool run using executable name only:

   uv tool run graphify install

4. Run with explicit package source:

   uv tool run --from graphifyy graphify install

Actual Behavior

• graphify install:

  zsh: command not found: graphify
  

• uv tool run graphify install:

  × No solution found when resolving tool dependencies:
  ╰─▶ Because there are no versions of graphify and you require graphify, we can conclude that your requirements are unsatisfiable.
  

• uv tool run --from graphifyy graphify install works.

Expected Behavior

After uv tool install graphifyy, at least one of the following should work consistently without additional discovery:

• graphify install (if PATH/tool shim is correctly set up)
• or docs should clearly instruct to use:

  uv tool run --from graphifyy graphify <command>

Notes

uv reports that package graphifyy provides executables graphify and graphify-mcp, which suggests confusion between package name and executable name. This is likely to affect first-time users.

Suggested Fixes

• Improve install/run documentation with explicit examples for macOS + zsh.
• Add a troubleshooting section for PATH setup (uv tool dir) and shell reloading.
• Optionally consider package/executable naming alignment to reduce friction.

[TPAteeq]

Opened a PR for this — it's a docs fix, not a code bug. Both behaviors you hit are expected uv:

• graphify: command not found — uv tool install puts the command in ~/.local/bin, which a fresh macOS/zsh shell doesn't have on PATH yet. uv even prints a warning about it at install time; uv tool update-shell (then open a new terminal) fixes it.
• uv tool run graphify … can't resolve graphify — uv tool run reads the first word as a package, and the package is graphifyy; graphify is only the command it ships. So the explicit form you found, uv tool run --from graphifyy graphify install (or uvx --from graphifyy graphify install), is the right call.

The README install note and Troubleshooting section now give both out with macOS/zsh examples. I left the package/executable names as-is — graphify is already taken on PyPI (hence graphifyy), and the CLI has to stay graphify for existing users. Thanks for the clean repro and the three-invocation breakdown — made it easy to pin down.

[safishamsi]

Documented on v8 (11dc819, PR #1474, thanks @Patsch36 for the report). The README install note + Troubleshooting now cover both: run uv tool update-shell (then a new terminal) if graphify isn't on PATH after uv tool install, and use uvx --from graphifyy graphify install since the package is graphifyy and graphify is only its console script. Ships in the next release.