History

Austin 2af401eb78 feat: redundant WSL brain serve + keepalive (fail-safe) - serve-brain-wsl.sh: serves WSL central brain over HTTP MCP :8090 (independent of Windows brain) - keepalive-brain-wsl.sh: restarts serve if :8090 drops - cron agentic-os-brain-keepalive-wsl every 5 min mirrors Windows keepalive - README documents the two independent :8090 endpoints (WSL + Windows)		2026-07-26 14:31:46 -07:00
..
README.md	feat: redundant WSL brain serve + keepalive (fail-safe)	2026-07-26 14:31:46 -07:00
agentic-os.json	feat: redundant WSL brain serve + keepalive (fail-safe)	2026-07-26 14:31:46 -07:00
build-central.sh	feat: central graphify brain (merged cross-project knowledge graph)	2026-07-26 12:44:25 -07:00
keepalive-brain-wsl.sh	feat: redundant WSL brain serve + keepalive (fail-safe)	2026-07-26 14:31:46 -07:00
link-project.sh	feat: central graphify brain (merged cross-project knowledge graph)	2026-07-26 12:44:25 -07:00
serve-brain-wsl.sh	feat: redundant WSL brain serve + keepalive (fail-safe)	2026-07-26 14:31:46 -07:00
serve-brain.sh	feat: central graphify brain (merged cross-project knowledge graph)	2026-07-26 12:44:25 -07:00
sync-to-windows.sh	feat: two-brain topology — WSL Agentic-OS brain + Windows standalone central brain	2026-07-26 13:04:16 -07:00

README.md

Central Brain — Graphify knowledge graph

One central, queryable brain that project graphs roll up into.

Topology (two brains)

Agentic-OS brain (WSL) — this folder. agentic-os.json + merged central-graph.json.
Windows central brain (device-wide, offline, standalone) — C:\Users\Austin\Brains\central\. Its own Python venv + Graphify, serves central-graph.json over HTTP MCP at http://127.0.0.1:8090/mcp from Windows. No WSL dependency at query time. WSL's sync-to-windows.sh pushes the merged graph into it hourly.

Per-project graphs: projects/<name>.json (linked via link-project.sh) roll up into central-graph.json here, which is then synced to Windows.

Commands (WSL side)

bash brain/graph/build-central.sh            # rebuild WSL central brain (code graph + merge linked projects)
bash brain/graph/link-project.sh <name> <graph.json>   # register a project's graph into the brain
bash brain/graph/sync-to-windows.sh          # rebuild + push merged graph to Windows central brain
bash brain/graph/serve-brain.sh             # serve WSL central brain over HTTP MCP (:8090)
bash brain/graph/serve-brain-wsl.sh         # redundant WSL serve (:8090, independent of Windows brain)
bash brain/graph/keepalive-brain-wsl.sh     # restart WSL serve if :8090 drops (fail-safe)

Set CENTRAL_BRAIN_PORT to override the serve port (default 8090).

What it contains today

Code symbols of agentic-os as nodes (functions/classes/modules), with call/import edges.
Linked projects (added via link-project.sh).
Memory NOTES (markdown under brain/) are NOT yet graph nodes. To make them queryable, set an LLM key (GEMINI_API_KEY / OPENAI_API_KEY / etc.) and run graphify . (no --code-only) so notes are semantically extracted. Until then, notes remain the write path; the graph indexes code structure.

Notes

graphify's MCP HTTP serve requires the extra: pip install "graphifyy[mcp]" (done in the venv).
The write path for memory is still brain/*.md + audit + data/; graphify reads those, never writes them.
Rebuild is scheduled hourly by the agentic-os-brain-rebuild cron.
WSL serve is kept alive every 5 min by the agentic-os-brain-keepalive-wsl cron (fail-safe; mirrors Windows keepalive-brain.bat).
Two independent brain endpoints exist on :8090 — WSL (this tree) and Windows (C:\Users\Austin\Brains\central\). Either can answer if the other is down.