claudetools/projects/msp-tools/guru-rmm/session-logs/2026-04-02-session.md

GuruRMM Session Log - 2026-04-02

Session Summary

Continued GuruRMM development. Fixed installer issues, built feature roadmap, and tested agent deployment on local machine (DESKTOP-0O8A1RL).

Accomplishments

1. Fixed Windows installer self-copy failure - Agent binary was downloaded directly to Program Files, then install tried to copy the running exe onto itself. Fixed by downloading to %TEMP% first.

2. Fixed install script service start timing - Service wasn't ready immediately after install. Added 3-retry loop with Start-Service SCM API instead of shelling out.

3. Fixed agent status config path - status command looked for agent.toml in CWD instead of C:\ProgramData\GuruRMM. Added fallback to CONFIG_DIR.

4. Tested real agent deployment - Successfully installed agent on DESKTOP-0O8A1RL via irm one-liner. Agent connected to server, shows online in dashboard under "Mike's Car" site (GREEN-OCEAN-5222).

5. Created feature roadmap - projects/msp-tools/guru-rmm/ROADMAP.md with comprehensive feature tracking for evaluating current codebase vs rewrite.

Git Commits (gururmm repo)

Commit	Description
a89d2dd	fix: Download agent to temp before install to avoid self-copy failure
32147a6	fix: Install script start retry loop + status config path fallback

Credentials (unchanged from previous session)

• GuruRMM Server SSH: guru@172.16.3.30 (vault: infrastructure/gururmm-server.sops.yaml)
• GuruRMM Dashboard: admin@azcomputerguru.com / GuruRMM2025
• GuruRMM DB: PostgreSQL 172.16.3.30:5432, db gururmm, user gururmm
• NPM: mike@azcomputerguru.com / r3tr0gradE99! (172.16.3.20:7818)
• Cloudflare API Token: U1UTbBOWA4a69eWEBiqIbYh0etCGzrpTU4XaKp7w

Infrastructure

• DESKTOP-0O8A1RL now has GuruRMM agent installed and running
  • Service: GuruRMMAgent (auto-start, LocalSystem)
  • Config: C:\ProgramData\GuruRMM\agent.toml
  • Binary: C:\Program Files\GuruRMM\gururmm-agent.exe
  • Site: Mike's Car (GREEN-OCEAN-5222)
  • Reports as: windows 11 (26200), online

Agents in System (5 total)

Hostname	OS	Status	Site
AD2	windows 10 (14393)	online	AZ Computer Guru - Main Office
gururmm	linux 22.04	online	AZ Computer Guru - Main Office
DESKTOP-0O8A1RL	windows 11 (26200)	online	Mike's Car
SL-SERVER	linux unknown	online	Scileppi Law Firm - Main Office
SL-SERVER	linux unknown	offline	Scileppi Law Firm - Main Office

Sites (5 total now)

Client	Site	Code
AZ Computer Guru	Main Office	SWIFT-CLOUD-6910
Glaztech Industries	SLC - Salt Lake City	DARK-GROVE-7839
Scileppi Law Firm	Main Office	WEST-MEADOW-9025
Valley Wide Plastering	Main Office	INNER-TIGER-8330
Mike's Car (new)	?	GREEN-OCEAN-5222

Feature Roadmap Summary

Full roadmap at projects/msp-tools/guru-rmm/ROADMAP.md. Key items added:

Dashboard/UI:

• D4: Global search across all agent details
• D5: Clickable metric cards -> drill-down views (process list, disk usage)
• D6: Real-time terminal (PS/cmd) via WebSocket tunnel
• D7: Remote file system browser
• D8: Remote registry editor (Windows)
• D9: Remote services manager

Agent:

• A3: Full OS detail (distro/version) for Linux
• A4: CPU/GPU temperature collection (not working on any machine)
• A5: Process list collection
• A6: Disk usage detail

Server:

• S2: Stackable/inheritable policy system (Company > Site > Machine)
• S3: Dynamic groups based on agent attributes (e.g., RAM <= 8GB)
• S4: Policy actions with custom script execution
• S5: Customizable alerting system (offline, disk, SMART, RAID, thresholds)
• S6: Alert notification channels (email, webhook, Slack/Teams)
• S7: Real-time tunnel mechanism for interactive tools

Pending / Next Steps

1. Build planning session - User wants to evaluate whether current codebase supports the roadmap or needs a rewrite
2. Agent data collection expansion - SMART data, RAID status, process lists, disk detail, temps
3. Real-time tunnel architecture - Separate from check-in WebSocket, multiplexed channels
4. Policy system design - Inheritance model, dynamic groups, script execution
5. More roadmap items - User indicated "a TON more things" to add

Session ID

41cb8b1a-6546-48f6-a37e-5223e9f2bbae