symbiote-scan

Symbiote Rescan

Trigger a full codebase rescan to update the knowledge graph with latest file changes.

When to Use

• After significant refactoring or restructuring
• When symbiote's context feels stale or out of date
• After pulling large changesets from remote
• When semantic search returns outdated results

Process

Step 1: Check Server Status

curl -s http://127.0.0.1:$(cat .brain/port)/internal/health 2>/dev/null || echo "not running"

If not running, start it after the scan completes.

Step 2: Run the Scan

For a standard rescan (structure + symbols + call graph):

npx -y symbiote-cli scan

For a full rescan with embedding regeneration (slower, enables better semantic search):

npx -y symbiote-cli scan --embeddings

To force a clean rescan ignoring cached state:

npx -y symbiote-cli scan --force

Step 3: Restart Server (if was running)

If the server was running before the scan, restart it to pick up the new graph:

npx -y symbiote-cli serve --no-open > /dev/null 2>&1 &

Wait for it:

sleep 3 && curl -s http://127.0.0.1:$(cat .brain/port)/internal/health

Step 4: Verify

Use the get_project_overview MCP tool to confirm the updated stats (file count, node count, edge count).

Output

One line:

Symbiote rescan complete — {N} files indexed, {N} nodes, {N} edges.