Restart a Brain Service
Canonical source: 00_MISSION_CONTROL/runbooks/brain-services/RUNBOOK_Brain_Service_Restart.md
:::danger Use the service-ops tool Live Brain currently runs as SYSTEM scheduled tasks. Use the service-ops tool so restart, port cleanup, and health checks stay consistent. :::
One command
pwsh -NoProfile -File B:\GRIFF_WARM\AI_AGENT_PLATFORM\00_MISSION_CONTROL\service-ops\Restart-GriffService.ps1 -Action restart -Service all
| Goal | Command |
|---|---|
| Status | Restart-GriffService.ps1 -Action status -Service all |
| Restart MCP | Restart-GriffService.ps1 -Action restart -Service Brain-MCP |
| Restart HTTP | Restart-GriffService.ps1 -Action restart -Service Brain-HTTP |
| JSON | add -Json |
Healthy output shows manager=schtask, taskActionOk=True, and healthy=True.
Live tasks
| Logical service | Scheduled task | Port |
|---|---|---|
| Brain HTTP | \GRIFF-Brain-HTTP | 8787 |
| Brain MCP | \GRIFF-Brain-MCP | 8788 |
The tool ends the task, clears orphaned port holders, starts it again, checks health, and writes a receipt under 06_SESSION_EVIDENCE/receipts/.
True checks
Invoke-RestMethod http://127.0.0.1:8787/ready
$headers = @{ Authorization = "Bearer $env:GRIFFAI_MEMORY_API_TOKEN" }
Invoke-RestMethod http://127.0.0.1:8787/l1l5/status -Headers $headers
Expected 2026-06-03: /ready has memory_items=177400; /l1l5/status has status=ready, sidecar_vectors=177400, unembedded_items=0, and no blockers.
Do not disturb
Ingest and OMNI remain held under separate recovery gates. Restarting Brain does not authorize enabling ingest, OMNI Docker services, broad migrations, VACUUM, or WAL checkpoint work.