Hooks

Where it lives

• hooks/session-start.shGitHub ↗
  Read the script

  #!/bin/bash
  # Checks for the code-review-graph knowledge graph and outputs
  # guidance for Claude Code at the start of every session.
  
  # Drain stdin so large hook payloads do not cause BrokenPipeError (#493).
  cat >/dev/null || true
  
  DB_PATH=".code-review-graph/graph.db"
  
  if [ -f "$DB_PATH" ]; then
      cat <<'INSTRUCTIONS'
  [code-review-graph] Knowledge graph is available.
  
  When answering questions about this codebase, prefer using the code-review-graph MCP tools before scanning files manually:
  - Use semantic_search_nodes_tool to find classes, functions, or types by name or keyword.
  - Use query_graph_tool with patterns like callers_of, callees_of, imports_of, importers_of, children_of, tests_for, inheritors_of, or file_summary to explore relationships.
  - Use get_impact_radius_tool to understand the blast radius of changes.
  - Use get_review_context_tool for token-efficient review context.
  - Fall back to Grep/Glob/Read only when the graph does not cover what you need.
  
  This saves significant tokens by avoiding full codebase scans.
  INSTRUCTIONS
  else
      echo "[code-review-graph] No knowledge graph found. Run /code-review-graph:build-graph to parse this codebase and enable graph-powered queries."
  fi
  

Read the script before you install anything that runs on your machine. This is the one part of a plugin that acts without being asked.