azcomputerguru/claudetools
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update GuruRMM agent PROJECT_STATE with Mac deployment (v0.6.1)

Browse Source 
- macOS ARM64 agent deployed to Mikes-MacBook-Air.local
- Agent ID: 001d5198-7807-4d63-b46d-069c9c10ed75
- Authenticated successfully with site code SWIFT-CLOUD-6910
- Remote command execution verified (root privileges)
- LaunchDaemon service configured
- Passwordless sudo rules created for manual operations
- Fixed authentication issue (api_key vs site_code)
- Deleted stale agent entry from April 3 crash

Machine: Mikes-MacBook-Air.local
Timestamp: 2026-04-20 19:45:00

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Mike Swanson
2026-04-19 19:39:43 -07:00
parent 94585fe426
commit af31c3a60c
1 changed files with 41 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
projects/gururmm-agent/PROJECT_STATE.md
View File

@@ -2,11 +2,13 @@
> Last updated: 2026-04-20
**Status:** COMPLETE
**Last Activity:** 2026-03-31
**Status:** ACTIVE
**Last Activity:** 2026-04-20
Rust/Tokio integration layer enabling Main Claude to invoke Claude Code CLI on AD2 (Windows Server 2022) via the GuruRMM WebSocket API. Rate-limited (10 tasks/hr), 2 concurrent max, 300s timeout. Implementation is production-ready but integration into the live GuruRMM agent binary was the pending step.
**NEW:** macOS agent v0.6.1 deployed to Mac (Mikes-MacBook-Air.local) on 2026-04-20. Agent successfully connects to RMM server (172.16.3.30:3001), authenticates with site code SWIFT-CLOUD-6910, and executes remote commands as root. LaunchDaemon service configured with passwordless sudo for GuruRMM operations.
## What Was Done
- `agent/src/claude.rs` — 684-line Rust module: ClaudeExecutor struct, input sanitization, rate limiting, concurrency control, timeout management, unit tests
@@ -15,6 +17,15 @@ Rust/Tokio integration layer enabling Main Claude to invoke Claude Code CLI on A
- `TESTING_AND_DEPLOYMENT.md` — 497-line complete deployment and testing guide
- `README.md` — full project documentation
## Recent Changes
| Date | By | Machine | Change | Status |
|------|-----|---------|--------|--------|
| 2026-04-20 | Mike | Mac | macOS agent v0.6.1 deployed - built ARM64 binary, configured LaunchDaemon, passwordless sudo setup, authenticated successfully, tested root command execution | DEPLOYED |
| 2026-04-20 | Mike | Mac | Deleted stale agent entry (6177bcac-e046-4166-ac76-a6db68a363ab) from RMM database - old connection from 2026-04-03 that crashed after 4 seconds | COMPLETE |
| 2026-04-20 | Mike | Mac | Fixed agent authentication - config file required `api_key = "SWIFT-CLOUD-6910"` (site code), not placeholder value | FIXED |
| 2026-04-20 | Mike | Mac | Created passwordless sudo rules for GuruRMM operations - `/etc/sudoers.d/claudetools` with wildcard paths to handle spaces | DEPLOYED |
## If Resuming
1. Copy `agent/src/claude.rs` into the live GuruRMM agent project (`azcomputerguru/gururmm`)
@@ -23,3 +34,31 @@ Rust/Tokio integration layer enabling Main Claude to invoke Claude Code CLI on A
4. Build with `cargo build --release`, run `cargo test` and `cargo clippy`
5. Deploy to AD2 per `TESTING_AND_DEPLOYMENT.md` (stop service, backup binary, deploy, restart, smoke test)
6. Note: this was built against the GuruRMM API at 172.16.3.30:3001 — verify agent ID for AD2 before sending commands
## macOS Agent Details (2026-04-20 deployment)
**Agent Info:**
- Agent ID: 001d5198-7807-4d63-b46d-069c9c10ed75
- Hostname: Mikes-MacBook-Air.local
- OS: macOS 26.3.1 (Darwin ARM64)
- Version: 0.6.1
- Site: Main Office (SWIFT-CLOUD-6910)
- Status: online
**Installation:**
- Binary: `/usr/local/bin/gururmm-agent` (3.2 MB ARM64)
- Config: `/Library/Application Support/GuruRMM/agent.toml`
- LaunchDaemon: `/Library/LaunchDaemons/com.azcomputerguru.gururmm.plist`
- Logs: `/Library/Logs/GuruRMM/agent.log` and `agent-error.log`
- Runs as: root (no UserName in plist)
**Command Execution:**
- Tested: `whoami && hostname && uname -a`
- Result: Executes as root successfully
- Execution time: 61ms
- Remote commands via RMM dashboard work without sudo prompts
**Passwordless Sudo:**
- File: `/etc/sudoers.d/claudetools`
- Purpose: Manual ClaudeTools operations (agent already runs as root)
- Syntax: Uses wildcards for paths with spaces (`/Library/Application*`)