docs: fix Graphify install instructions (dead brew tap)#2
Open
pmihalcin wants to merge 1 commit into
Open
Conversation
The install command in the code-graph guide and the init skill points at brew install graphifylabs/tap/graphify, but the graphifylabs/homebrew-tap repository does not exist (git clone fails with 'Repository not found'), and https://graphifylabs.ai/install returns 404. Anyone following the guide hits a dead end. Replace all install references with the upstream-official method (uv tool install graphifyy, pipx as alternative), matching both the Graphify README and the command shown on graphifylabs.ai itself. Also call out that the double-y PyPI name is intentional — automated review tooling (and humans) otherwise flag it as a likely typosquat of 'graphify', which is an unaffiliated package. Touched: code-graph guide, init skill, graphify skill, and the graphify-orchestrate.py not-installed error message. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The code-graph guide (and the init skill) tell users to install Graphify with:
That tap doesn't exist —
github.com/graphifylabs/homebrew-tapreturns Repository not found, so the command fails. The fallback linkhttps://graphifylabs.ai/installis a 404 too. Following the guide today is a dead end.There's a second, subtler failure mode: the correct PyPI package name is
graphifyy(double-y — upstream README confirms othergraphify*names are unaffiliated). When an agent tries to install it, automated safety tooling can flag the double-y name as a likely typosquat and block the install — Claude Code's permission classifier did exactly that in my session. Docs that state the name is intentional help both humans and agents past that.Change
Replaced every install reference with the upstream-official method, matching both the Graphify README and the command shown on graphifylabs.ai:
uv tool install graphifyy # or: pipx install graphifyydocs/.../guide/code-graph.md— new install block + note on the double-y name and PATH (~/.local/bin,uv tool update-shell/pipx ensurepath)skills/init/SKILL.md— same command in the guided-install stepskills/graphify/SKILL.md— parenthetical install hint updated frompip installscripts/graphify-orchestrate.py— thegraphify not installedstderr hint (also dropped&& graphify install— that step registers Graphify's own/graphifyskill with the assistant and isn't needed for Strata, which only shells out to thegraphifybinary)Verified end-to-end on a real repo:
uv tool install graphifyy→/strata:graphifybuilt a 13.5k-node graph and wrote the Obsidian notes.🤖 Generated with Claude Code