Find all references to the symbol at the given position across the project.

Rename the symbol at the given position across all files in the project.

Return the file and line where the symbol at the given position is defined.

Return completion suggestions at the given cursor position.

List all FastAPI routes across the entire project, with full paths (router prefixes applied).

Get the full Depends() injection tree for a FastAPI handler across the entire project.

Includes router-level, include_router, decorator-level and signature dependencies. handler may be a function name, a "Class.method" qualname, or a graph id ("app.routes.users:list_users").

List all Pydantic BaseModel classes defined in a file.

Inspect a Pydantic model: fields with types/defaults, and validators.

Find all places a Pydantic model is used as a type annotation across the project.

Detect FastAPI routes missing a response_model declaration.

Build a full dependency graph for the routes of a file: route → handler → dependencies → models.

Detect field mismatches between a SQLAlchemy ORM model and a Pydantic schema.

Build or refresh the project's FastAPI knowledge graph and return its statistics.

The graph links routes, handlers, dependencies, schemas, ORM models, SQL tables, templates and function calls. It is cached in /.fastapi-architect/ and only changed files are re-parsed, so other graph tools are fast. Use force=True to rebuild from scratch.

Explore the knowledge graph around a node.

node can be a graph id, a route ("GET /api/users/" or "/api/users/"), a table name, or a function/class name. direction is "out" (what it uses), "in" (what uses it) or "both". edge_types filters edges, e.g. ["DEPENDS_ON", "CALLS"]. Valid types: INCLUDES, HAS_ROUTE, HANDLED_BY, DEPENDS_ON, ACCEPTS, RETURNS, CALLS, USES, QUERIES, RENDERS, MIDDLEWARE, INHERITS, MAPS_TO, REFERENCES, RELATES_TO, MIRRORS, DEFINES (excluded by default).

What is affected if symbol changes: routes, handlers, dependencies, schemas, ORM models...

Follows reverse edges (callers, users, dependents, subclasses, mirroring schemas, tables → models). Each impacted route includes a via chain explaining why. symbol accepts the same forms as graph_neighbors (e.g. "User", "get_db", "users" for a table, "app.models.user:User").

Shortest paths between two nodes, e.g. from a route to a table ("POST /chat" → "chat_logs").

Directed paths are tried first; if none exists, direction is ignored and directed is false.

Project-wide checks: write routes without auth, duplicate routes, routers never mounted, unused schemas, unreferenced ORM models, dependency cycles and parse errors.

Auth is inferred from dependency names, auth Header params and calls to auth-like functions. Pass auth_dependencies (function names) to declare custom guards the heuristics miss.

A concise Markdown overview of the project: stats, routes with their auth, hubs and audit findings. Good first call to understand an unfamiliar FastAPI codebase. With save=True the report is also written to /.fastapi-architect/GRAPH_REPORT.md.

Export the knowledge graph as a standalone interactive HTML page (open it in a browser).

Nodes are colored by type (Route, Handler, Dependency, Schema, ORMModel, Table...), with search, type filters and a details panel listing each node's connections. Defaults to /.fastapi-architect/graph.html. Rendering loads vis-network from a CDN.