Sypha AI Docs
Advanced Usage

Code Graph

A live, navigable knowledge graph of your entire codebase — maps every symbol, file, and dependency so Sypha can answer structural questions instantly.

Code Graph gives teams a live, navigable knowledge graph of their entire codebase. Rather than searching through files manually, Code Graph maps every symbol, file, and dependency so Sypha can answer structural questions instantly.

[!NOTE] Code Graph is available on Team and Enterprise plans.

What Code Graph Shows

ViewWhat It Reveals
Callers & CalleesWhich functions call a given function, and what it calls in turn
Import graphDirect and transitive import chains across the project
Test coverage linksWhich test files exercise a given module or function
Impact radiusEverything that would be affected if a file or symbol changed

These four views give you and Sypha a complete structural picture of your codebase — not just what the code does, but how every part connects to every other part.

How to Use It

Opening the Code Graph Panel

  1. Click the Code Graph icon in the Sypha toolbar (or open the Code Graph tab in the side panel).
  2. The graph renders immediately — nodes are files and symbols, edges are relationships.
  • Click on any symbol, file, or keyword to jump to its graph node.
  • Use the Flow, Trees, Clusters, Dirs, Treemap view toggles to change the visualisation mode.
  • Filter by All, Imports, Calls, Refs to focus on the relationship type you care about.
  • Use Cluster mode to see how your codebase is naturally grouped into functional modules.

Handing Off to AI

  • Select a node or set of nodes and use the Handoff to AI action to send that graph context directly into Strategist Mode for architecture review.
  • During code review, Code Graph highlights the blast radius of a change before you merge — Sypha shows you what breaks before it breaks.

Key Benefits

BenefitDescription
Faster navigationJump to callers and dependents without grepping through files
Safer refactoringSee the full impact radius before renaming or moving code
Richer AI contextSypha uses graph relationships to give more accurate, structurally-aware answers
Code review supportRisk-scored change analysis based on structural relationships

Health Score

The Code Graph panel includes a Health Score for your codebase (graded A–F). It factors in:

  • Number of clusters and their cohesion
  • Ratio of functions to test coverage links
  • Circular dependency presence
  • Overall link density

Use the health score to track structural quality over time and identify areas of the codebase that are becoming fragile.

Example Workflow

1. Open Code Graph and find the function you are about to refactor
2. Switch to "Callers" view — see every callsite across the project
3. Check "Impact radius" — identify all files that would need updating
4. Hand off the graph context to Strategist Mode: "Refactor this to X — here's what calls it"
5. Sypha executes the refactor with full awareness of all affected callsites

Availability

Code Graph is enabled automatically on Team and Enterprise plans. If you are on an individual plan and want to try it, contact support or upgrade from the Plans page.

On this page