Projects Management Repo (auto-updated by OpenClaw)

Goal

• OpenClaw updates this repo automatically (on main) to keep a durable project index.
• Humans read it offline. Do not hand-edit PROJECTS_INDEX.md.

Files

• projects.json Source of truth (machine-edited)
• PROJECTS_INDEX.md Generated from projects.json (human-readable)
• tools/projectsctl The ONLY allowed writer (adds/updates + commits + pushes)
• tools/render_projects_index.py Generator/validator

Prereqs (Debian/Ubuntu)

• sudo apt-get update
• sudo apt-get install -y git jq python3 util-linux

Bootstrap

1. Generate the index: ./tools/projectsctl render

2. Add a project (example): PROJREPO=$(pwd) ./tools/projectsctl add "CognitiveOS" active
   "https://git.molloyhome.net/mmolloy/Cognition-OS"
   "/home/openclaw/.openclaw/workspace/repo-Cognition-OS"
   "Deterministic microkernel-style control plane for LLM/agent systems."

3. Change status: PROJREPO=$(pwd) ./tools/projectsctl set-status "CognitiveOS" paused

4. Update notes: PROJREPO=$(pwd) ./tools/projectsctl update-notes "CognitiveOS" "New notes here..."

Making OpenClaw read this reliably

• Symlink PROJECTS_INDEX.md into OpenClaw’s indexed memory folder:

  ln -sf /opt/projects/projects-mgmt/PROJECTS_INDEX.md ~/.openclaw/memory/projects_index.md sudo systemctl restart openclaw-gateway

Then confirm it’s indexed: sqlite3 ~/.openclaw/memory/main.sqlite "SELECT path FROM files WHERE path LIKE '%projects_index%';"

Operational contract (recommended)

• OpenClaw MUST use tools/projectsctl for any changes.
• Never edit PROJECTS_INDEX.md directly.
• If push fails, OpenClaw must report the error (no silent drift).