simple_graphify - Quick API Reference

CLI in one screen

simple_graphify build <path>             # graph a project -> <path>/graphify-out/
simple_graphify query "question"          # scoped subgraph as compact markdown
simple_graphify explain <NAME>            # one node + ALL its connections
simple_graphify path <A> <B>              # shortest connection chain
simple_graphify stats                     # node/edge kind counts, top degrees
simple_graphify report                    # re-emit GRAPH_REPORT.md to stdout
simple_graphify annotate edges.json       # merge assistant-inferred edges
simple_graphify install                   # install the Claude Code skill

Query commands read ./graphify-out/graph.json by default, or take --graph FILE.

Build options

simple_graphify build D:/prod/my_lib
    --out DIR             # output directory (default <path>/graphify-out)
    --mode deep           # add feature-level nodes
    --exclude "a,b,c"     # skip directory names (e.g. vendored trees)
    --no-docs             # skip markdown scanning
    --full-deps           # include ISE/Gobo externals as nodes

Library facade (Eiffel)

local
    g: SIMPLE_GRAPHIFY
do
    create g.make
    if g.build ("D:/prod/my_lib", "", False, True, False) then
        print (g.last_summary)
        print (g.query ("how does parsing work", 1, 30))
        print (g.explain ("MY_PARSER"))
        print (g.path_between ("MY_APP", "MY_STORE"))
    else
        print (g.last_error)
    end
end

Common operations

I want to...	Do this
Map a repo for Claude Code	`simple_graphify build .` then `simple_graphify install`
Ask "what depends on X"	`simple_graphify explain X` and read the Incoming section
See how two subsystems relate	`simple_graphify path A B`
Find the architecture hubs	open `graphify-out/GRAPH_REPORT.md`, God Nodes section
Browse the graph visually	open `graphify-out/graph.html` in a browser
Exclude vendored source trees	`--exclude "gobo-gobo-25.09,third_party"`
Record an insight the scanner can't see	write `edges.json`, run `annotate` (edge lands as `inferred`)

Reading edges

SIMPLE_HTTP --uses--> HTTP_COOKIE_JAR (extracted, w11)

kind: inherits | uses | creates | contains | depends_on | references | mentions
confidence: extracted = explicit in source; inferred = derived (comment mentions, annotate); ambiguous = uncertain
w: occurrence count (how often the connection appears)

Full details in the API Reference.