azcomputerguru/claudetools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
af529f953d73f5ca2bbf13797bc9c457f5896730
claudetools/wiki/projects/msp-tools.md
Mike Swanson 70c496bb30 wiki: compile 5 missing articles + dedupe neptune queue entry 
Seeded via /wiki-compile (parallel sub-agents):
- clients: gonzvar-tax-services, tohono-oodham-doit (Syncro 33069069),
  tucson-golden-corral (Syncro 3859123)
- projects: gururmm-agent (artifact-based, agent/ @ origin/main), msp-tools (umbrella)
Index rows added for all five. Deduped the duplicate system:neptune compile-queue
entry (merged the cert/DkimSigner note into one).

Left as-is (intentional, not duplicates/dead): wiki/projects/guru-rmm.md is a
redirect tombstone; the patterns/tailscale-client-enroll.ps1 index link is valid
(the .ps1 script exists).
2026-06-12 08:06:07 -07:00

7.2 KiB
Raw Blame History

type, name, display_name, last_compiled, compiled_by, sources, backlinks
type name display_name last_compiled compiled_by sources backlinks
project msp-tools MSP Tools (umbrella) 2026-06-12 GURU-5070/claude-main
projects/msp-tools/session-logs/2026-06-02-recovered-build-self-diagnosis-skill-for-claudetools-setup.md
projects/msp-tools/session-logs/2026-06-02-recovered-build-self-diagnosis-skill-for-claudetools-setup-25f5d8b9.md
projects/msp-tools/README.md
.claude/memory/project_gururmm.md
.claude/memory/project_guruconnect.md
.claude/memory/reference_msp_audit_scripts.md
projects/gururmm
projects/guruconnect

MSP Tools (Umbrella)

Summary

projects/msp-tools/ is the umbrella directory for ACG's MSP tooling under ClaudeTools. It hosts two active product submodules (gururmm and GuruConnect), plus supporting PowerShell modules, audit scripts, and operational utilities. The directory was originally populated in January 2026 by importing conversation archives from prior Claude projects; active development now lives in the submodules and supporting directories with their own session-log trees.

This article covers the umbrella scope only. For the full capability record of each product, see the dedicated articles linked below.

Sub-Projects

Directory Type Purpose Wiki Article
guru-rmm/ git submodule Full-stack RMM: agent fleet, monitoring, remote execution, dashboard gururmm
guru-connect/ git submodule Remote access / screen sharing product (Rust; native-first, WebRTC fallback) no article yet (verify)
guru-scan/ PowerShell module Multi-engine malware scan orchestrator; runs RKill + scanner chain, outputs JSON for GuruRMM agent —
msp-audit-scripts/ PowerShell scripts On-demand server and workstation audit scripts; run via ScreenConnect Toolbox as SYSTEM —
quote-wizard/ PHP/web app MSP quoting tool (PHP API + frontend + admin panel) — maturity/status (verify) —
scripts/ Misc scripts M365 onboarding (CIPP templates, tenant onboarding, permission manifests), Datto SmartBadge diagnostics, RMM status check —
utilities/ Standalone PS1 Printer port cleanup, Win11 upgrade script, saved ScreenConnect Toolbox one-liners —
toolkit/ (empty README) Purpose (verify) —

Archived conversation imports (not active code):

  • guru-rmm-conversation-logs/ — 54 JSONL transcripts from the original GuruRMM Claude project, imported 2026-01-17
  • guru-connect-conversation-logs/ — 40 JSONL transcripts from the original GuruConnect Claude project, imported 2026-01-17

Architecture

Components

Component Location Tech State
GuruRMM projects/msp-tools/guru-rmm/ (submodule) Rust (server + agent), TypeScript (dashboard), PostgreSQL Active — see gururmm
GuruConnect projects/msp-tools/guru-connect/ (submodule) Rust (server + Windows agent), TypeScript (dashboard), PostgreSQL Active — v2 in dev
GuruScan projects/msp-tools/guru-scan/ PowerShell module Active
MSP Audit Scripts projects/msp-tools/msp-audit-scripts/ PowerShell Active; mirrored on Howweird/msp-audit-scripts (GitHub)
Quote Wizard projects/msp-tools/quote-wizard/ PHP + frontend Status (verify)

Key Files & Repos

  • GuruRMM repo: azcomputerguru/gururmm on Gitea (172.16.3.20)
  • GuruConnect repo: azcomputerguru/guru-connect on Gitea (172.16.3.20) — separate repo, NOT a submodule of ClaudeTools
  • MSP Audit Scripts remote: https://raw.githubusercontent.com/Howweird/msp-audit-scripts/master/
  • GuruScan config: projects/msp-tools/guru-scan/scanners.json

Development

Current Focus

Active development is in the submodules. See gururmm for GuruRMM's current sprint. GuruConnect is undergoing v2 architecture (native-first remote access, Rust relay/auth rebuild, bidirectional clipboard file transfer). The other tools (GuruScan, audit scripts, utilities) are maintained but not under active sprint.

Patterns & Anti-Patterns

  • GuruRMM and GuruConnect are each versioned products with their own CI/CD pipelines, changelogs, and session-log trees. Do not conflate umbrella session logs with product session logs.
  • The README.md at the umbrella root is stale (dated 2026-01-17; describes the directory as a conversation-import archive — that framing is obsolete). Do not rely on it for current state.
  • guru-rmm-conversation-logs/ and guru-connect-conversation-logs/ are read-only import archives. Development context lives in the submodule repos and root session-logs/.

Build & Deploy

Each product has its own build and deploy procedure. See gururmm for GuruRMM. For GuruConnect, see the deploy procedure in .claude/memory/project_guruconnect.md (manual build on server 172.16.3.30, login shell required for cargo/protoc on PATH).

Own Session Logs — Work Captured

The projects/msp-tools/session-logs/ directory holds two recovered log files, both reconstructed from the same transcript (25f5d8b9, 2026-06-02T21:14–22:06 UTC). They cover building the /self-check ClaudeTools harness diagnostic skill — this is ClaudeTools infrastructure work, not an MSP tool feature. The logs were saved here rather than root session-logs/; the reason is unclear (verify if misclassified).

Work done in those sessions (2026-06-02):

  • Assessed existing ClaudeTools diagnostic infrastructure; determined a new harness self-check skill was needed.
  • Created manifest.json (baseline, v1.0.0 provisional) as the single source of truth for all machines — required tools vs capability-gated tools, per-tier rules.
  • Created self-check.sh (cross-platform bash; runs probes, grades machine, publishes census to coord API).
  • Created command wrapper at .claude/commands/self-check.md and skill docs at .claude/skills/self-check/.
  • First run on GURU-5070 (windows/amd64): Grade AMBER — PASS 71, WARN 2, FAIL 0.
  • Resolved: jq (winget build) emitting \r\n line endings causing false negatives in hook/path resolution; patched with a jq wrapper.
  • Found: post-commit hooks not installed despite HOOKS.md mandate; found autotask.md missing on Linux machine.

Pending from those sessions (unresolved as of log date):

  • Manifest to be moved from provisional to ratified status.
  • Validate --json output and graceful aggregate degradation.
  • Mandatory code review for the self-check engine before committing.

Active State

See gururmm for GuruRMM's live state. GuruConnect v2 in development; v1 prod at connect.azcomputerguru.com (172.16.3.30:3002 behind NPM). Self-check skill status: AMBER on GURU-5070 as of 2026-06-02; fleet aggregate status (verify current via coord API selfcheck_* components under claudetools project key).

History Highlights

  • 2026-01-17 — Original import of guru-rmm (54 files, 14 MB) and guru-connect (40 files, 6.1 MB) conversation archives into projects/msp-tools/
  • 2026-05-30 — GuruConnect v2 deployed to production at connect.azcomputerguru.com
  • 2026-06-02 — /self-check harness skill built; GURU-5070 grades AMBER on first run

Backlinks

  • gururmm — GuruRMM product article (full capability record)
  • GuruConnect wiki article not yet created (verify — slug would be guruconnect)
Reference in New Issue View Git Blame Copy Permalink