| 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
- Prefer these scripts over guessing from raw logs.
- If the snapshot says
anomaly_detected: false, do not fabricate an emergency.
- If the snapshot says
anomaly_detected: true, include the exact reasons and current context.
- Use the runtime status script before changing gateway, cron, or memory configuration.
- 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.
