| name | symbiote-scan |
| description | Trigger a full codebase rescan to update Symbiote's knowledge graph with latest changes. This skill should be used when the user asks to "rescan the project", "update the code graph", "rebuild symbiote index", "rescan codebase", or "refresh symbiote". Optionally regenerates embeddings for semantic search. |
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.
