Files
claudetools/wiki/overview.md
Mike Swanson cbbea8b267 wiki: compile overview.md — cold-start orientation doc
Synthesized from all 6 seeded wiki articles (cascades-tucson, gururmm,
gururmm-build, jupiter, pluto, uranus) + CLAUDE.md. Covers team, all
clients, internal projects (GuruRMM + ClaudeTools), full infrastructure
table, tooling stack, key URLs, and cross-cutting open action items.
Updated wiki/index.md Overview row and removed overview from compilation queue.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-24 15:56:04 -07:00

8.7 KiB

type, name, display_name, last_compiled, compiled_by, sources
type name display_name last_compiled compiled_by sources
overview overview ClaudeTools Overview 2026-05-24 DESKTOP-0O8A1RL/claude-main
wiki/clients/cascades-tucson.md
wiki/projects/gururmm.md
wiki/systems/gururmm-build.md
wiki/systems/jupiter.md
wiki/systems/pluto.md
wiki/systems/uranus.md
.claude/CLAUDE.md

ClaudeTools Overview

Cold-start orientation for Arizona Computer Guru LLC. Read this first. Follow backlinks into individual wiki articles for depth.


Business

Arizona Computer Guru LLC — managed service provider based in Tucson, AZ. Two-person operation. Primary business model: monthly MSP contracts + prepaid hour blocks. Side track: internal tooling developed for external productization (GuruRMM, GuruPSA).


Team

Person Handle Role Notes
Mike Swanson mike Owner / President / admin Primary developer; runs GuruRMM dev, ClaudeTools, infrastructure
Howard Enos howard Technician / employee Field work, Cascades onsite, billing, client tickets; full system trust

Shared Gitea push account: azcomputerguru. Commits tracked by author (git config per machine).


Clients

Client Type Status Primary Project
Cascades of Tucson Prepaid block $175/hr Active — dept-by-dept domain migration ongoing Entra Connect staging, domain join, HIPAA compliance, M365 licensing
BirthBiologic MSP contract (assumed) Active GuruRMM site BRIGHT-PEAK-5980; BB-SERVER on 0.6.37 straggler
Paul Key MSP contract (assumed) Active GuruRMM site IRON-WOLF-5819

Cascades is the highest-complexity engagement: single DC on aging Dell R610 hardware, HIPAA obligation, active multi-phase domain migration, and multiple open blocking items. See clients/cascades-tucson for full detail.

BirthBiologic and Paul Key are monitoring-only in the wiki as of 2026-05-24 — articles not yet seeded.


Internal Projects

GuruRMM

projects/gururmm — Remote Monitoring & Management platform. Rust/Axum server + React dashboard + cross-platform Rust agent. Production-deployed. ~55 enrolled agents across client sites and ACG internal machines. Current version: 0.6.38 (2026-05-24).

Layer URL / Location Tech
API server http://172.16.3.30:3001 / https://rmm-api.azcomputerguru.com Rust, Axum
Dashboard https://rmm.azcomputerguru.com React, TypeScript, Vite, shadcn/ui, Tailwind v4
Database postgres://localhost:5432/gururmm on 172.16.3.30 PostgreSQL 14
Gitea repo http://172.16.3.20:3000/azcomputerguru/gururmm active; D:\claudetools\projects\msp-tools\guru-rmm is a stale reference copy
Build webhook 172.16.3.30:9000 webhook-handler.py → per-platform build scripts
Windows builds Pluto (172.16.3.36) Rust MSVC + WiX v4

Active development focus: tray IPC peer authorization, auto-update reliability for agents with flaky WebSockets, watchdog alerts UI (2 missing server routes), MSP360 management phase.

Critical security backlog: credentials/:id/reveal (horizontal privilege escalation, HIGH) and internal_err() (~130 raw DB error exposures, HIGH).

ClaudeTools

MSP work-tracking system and internal tooling platform. Production-ready.

Layer URL / Location Tech
API http://172.16.3.30:8001 FastAPI / Python
Coord API http://172.16.3.30:8001/api/coord FastAPI (within ClaudeTools API)
Database MariaDB 10.6.22 @ 172.16.3.30:3306, DB: claudetools MariaDB
Schema 95+ endpoints, 38 tables, JWT auth, AES-256-GCM encryption

Coord API is the live inter-session coordination layer — tracks project locks, component states, and cross-session messages. All Claude sessions check and write to it.


ACG Infrastructure

All systems reside on ACG office LAN (172.16.x.x). pfSense at 172.16.0.1 is the router, DNS server, and Tailscale subnet router for remote access.

System IP Role Article
Jupiter 172.16.3.20 Unraid primary NAS; virsh host for all VMs; Docker: Gitea (:3000), NPM (:7818), Seafile (:8082) systems/jupiter
gururmm-build 172.16.3.30 Linux VM on Jupiter; GuruRMM API :3001, ClaudeTools API :8001, MariaDB :3306, PostgreSQL :5432, build pipeline :9000 systems/gururmm-build
Pluto / Claude-Builder 172.16.3.36 Windows Server 2019 VM on Jupiter; sole Windows MSI + cargo build server for GuruRMM systems/pluto
Uranus 172.16.3.21 Unraid secondary (Dell R730xd); OwnCloud archive storage only; RAM too low for any VM hosting systems/uranus
Neptune 172.16.3.11 / 67.206.163.124 Exchange Server 2016; ACG mail server for hosted clients; physically colocated at Dataforth D2 (article not yet seeded)
OwnCloud VM 172.16.3.22 OwnCloud (cloud.acghosting.com); storage backed by Uranus SMB share Storage (article not yet seeded)
Saturn DECOMMISSIONED Was 172.16.3.21; IP reused by Uranus, Apr 2026. Any "Saturn" reference in GuruRMM fleet is stale or actually Uranus.

Neptune note: ACG infrastructure physically located at Dataforth D2. Dataforth's UDM uses an overlapping 172.16.x.x subnet. Internal access to Neptune from the ACG office requires routing through D2TESTNAS. TODO: resubnet Dataforth UDM to eliminate the overlap.

Gitea internal URL: Always use http://172.16.3.20:3000 for API calls and curl. git.azcomputerguru.com is Cloudflare-fronted and blocks direct curl.


Tooling & Stack

Tool Purpose Where
SOPS vault Encrypted secrets storage; wraps age-encrypted YAML files D:/vault/ on Windows; vault.sh wrapper reads machine path from .claude/identity.json
1Password Secondary credential store (service account in vault) op://Infrastructure/... references
Gitea Self-hosted Git; all active repos http://172.16.3.20:3000
GuruRMM Agent deployment, command execution, fleet monitoring https://rmm.azcomputerguru.com
Syncro PSA / ticketing / billing External SaaS; API base documented in .claude/REFERENCE.md
GrepAI Semantic search over session logs, wiki, .claude/ grepai.exe search / MCP tools; indexes auto on file change
Ollama Local LLM — prose, summaries, classification; Tier 0 model routing localhost:11434 (DESKTOP-0O8A1RL) / 100.92.127.64:11434 (Tailscale)
Tailscale Remote access and cross-machine LAN Subnet router on pfSense (172.16.0.1)

Key URLs Quick Reference

Resource URL
GuruRMM dashboard https://rmm.azcomputerguru.com
GuruRMM API (internal) http://172.16.3.30:3001
ClaudeTools API http://172.16.3.30:8001
Coord API http://172.16.3.30:8001/api/coord
Gitea (internal) http://172.16.3.20:3000
NPM admin http://172.16.3.20:7818
Unraid (Jupiter) http://172.16.3.20
Unraid (Uranus) http://172.16.3.21
OwnCloud https://cloud.acghosting.com

Cross-Cutting Open Action Items

These are open items that span multiple systems or clients, as of 2026-05-24. See individual articles for full detail.

Item Priority Owner Reference
Fix NPM proxy: rmm-api.azcomputerguru.com still points to 172.16.3.20:3001; should be 172.16.3.30:3001 High Mike systems/jupiter
Verify and clean up "Saturn" GuruRMM agent entry Medium Mike systems/uranus, projects/gururmm
Resubnet Dataforth UDM (eliminate 172.16.x.x overlap with ACG office LAN) Medium Mike systems/gururmm-build (Neptune note)
Cascades: exit Entra Connect from staging mode High Mike/Howard clients/cascades-tucson
Cascades: M365 relicensing (31 SPB seats time-sensitive) High Mike clients/cascades-tucson
Cascades: ALIS SSO — blocked on Medtelligent Medium Mike clients/cascades-tucson
Cascades: break-glass accounts + YubiKeys Medium Howard clients/cascades-tucson
Cascades: audit retention infra (LAW 90d + Storage 6yr) Medium Mike clients/cascades-tucson
GuruRMM: fix credentials/:id/reveal privilege escalation High Mike projects/gururmm
GuruRMM: fix internal_err() at ~130 call sites High Mike projects/gururmm
GuruRMM: auto-update reliability for BB-SERVER + RECEPTIONIST-PC Medium Mike projects/gururmm
Seed wiki articles: system:neptune, client:birthbiologic, client:key-paul Low wiki/index.md