mac-cortex

name	mac-cortex
description	Monitor the local Mac and Hermes runtime with real scripts, including context-aware anomaly detection and a compact runtime status report.
version	1.0.0
author	Chris Cortex
license	MIT
platforms	["macos","linux"]
metadata	{"hermes":{"tags":["monitoring","observability","anomaly-detection","runtime","mac"],"related_skills":["ai-sniffer","execution-router"],"requires_tools":["terminal"]}}

Mac Cortex

Use this skill for real system monitoring, runtime inspection, or anomaly checks.

Core Commands

System snapshot with anomaly detection:

~/.hermes/hermes-agent/venv/bin/python ~/.hermes/scripts/system_snapshot.py

Compact Hermes runtime status:

~/.hermes/hermes-agent/venv/bin/python ~/.hermes/scripts/cortex_status.py

What The Snapshot Script Does

• captures CPU, memory, disk, load average, and thermal state
• tags the current machine context as build, watcher, or idle
• stores a rolling metric history under ~/.hermes/cache/cortex_metrics.json
• compares the current sample against same-context baselines
• emits a machine-readable anomaly verdict with reasons

What The Status Script Does

• shows the configured model and reasoning level
• shows gateway state and live platform connections
• shows registered cron jobs
• shows memory mode
• summarizes recent warnings and errors from Hermes logs

Rules

1. Prefer these scripts over guessing from raw logs.
2. If the snapshot says anomaly_detected: false, do not fabricate an emergency.
3. If the snapshot says anomaly_detected: true, include the exact reasons and current context.
4. Use the runtime status script before changing gateway, cron, or memory configuration.
5. These scripts require Python dependencies: psutil for system_snapshot.py and PyYAML (yaml) for cortex_status.py. If either import fails, report the missing dependency instead of pretending the monitoring run succeeded.

Verification

• The scripts must return valid JSON.
• system_snapshot.py should persist history to ~/.hermes/cache/cortex_metrics.json.
• cortex_status.py should report the current config and gateway state without crashing.
• Prefer the Hermes venv wrapper above so interactive runs and cron runs share the same dependency set.