{
  "name": "module-management",
  "description": "How to view, edit, test, reload modules and manage startup configuration",
  "tags": [
    "modules",
    "editing",
    "code",
    "self-improvement"
  ],
  "category": "dev",
  "created": "2026-06-22T19:02:49.949Z",
  "updated": "2026-06-22T19:02:49.949Z",
  "content": "---\nname: module-management\ndescription: How to view, edit, test, reload modules and manage startup configuration\ntags: [modules, editing, code, self-improvement]\ncategory: dev\n---\n## Steps\n1. **View module source:**\n   - view_module(name) — fetches original source or reads from _mods/ if edited\n   - Supports all loaded modules: SystemModule, FileSystemModule, SearXNGModule, etc.\n   - Or use modules command for GUI module manager\n\n2. **Edit a module:**\n   - edit_module(name) — copies source to _mods/<name>.js and opens code editor\n   - Editor shows the full source in a textarea\n   - Click \"Save & Test\" to save and auto-load the edited version\n   - Checkpoint before editing: checkpoint mod-edit-<name>\n\n3. **Test and reload:**\n   - test_module(name) — loads edited module from _mods/ for live testing\n   - reload_module(name) — discards edits and reloads from original URL\n   - list_modified_modules — shows all modules with pending edits\n\n4. **Check for updates:**\n   - check_updates — HEAD-requests all loaded module URLs to verify reachability\n\n5. **Manage startup:**\n   - startup-modules — opens the Startup Modules UI to select which modules load\n   - load-local <path> — load a module from VFS or URL without editing\n   - loadmod <url> — alternative: load module from URL\n   - removemod <name> — remove a loaded module\n\n6. **Agent modules (Phase 2):**\n   - module-agent-registry.js — Agent registry with agent-list, agent-register, agent-unregister, agent-status\n   - module-leases.js — Time-bound contracts with 5s watchdog, auto-expiry\n   - module-orchestrator.js — Spawn, delegate, kill, purge with heartbeat monitoring\n\n7. **When to use:**\n   - User reports a bug in a module → view_module, edit_module, test_module\n   - User asks \"can you add X feature?\" → same workflow\n   - Always save edits before testing. If test fails, the original module stays loaded."
}