maintenance

Run automated health checks and repairs on the Samara organism via shell commands.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/claudeaceae/samara-main --skill maintenance-claudeaceae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maintenance
Source: https://github.com/claudeaceae/samara-main/tree/main/.claude/skills/maintenance
Command: npx skills add https://github.com/claudeaceae/samara-main --skill maintenance-claudeaceae

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintaining an operating Samara organism requires routine checks to detect drift, ensure essential services are running, and fix integrity issues before they impact performance.

Core Features & Use Cases

  • Drift detection and repair: verifies alignment with expected system state and corrects drift when found.
  • Service verification: ensures launchd services and Samara.app are active and healthy.
  • Lock and integrity checks: detects stale locks and verifies critical symlinks for reliability.
  • Use Case: After a system update, run maintenance to confirm services restart properly and no drift remains.

Quick Start

Run a quick health check: ~/.claude-mind/system/bin/sync-organism --check && echo "No drift detected" || echo "Drift detected"

Perform full maintenance: ~/.claude-mind/system/bin/sync-organism

Frequently Asked Questions about maintenance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect and repair system drift after a macOS update?

To detect and repair system drift after an update, run the sync-organism maintenance script which verifies alignment with the expected system state, checks launchd services, and automatically corrects drift when found.

What is the best way to verify launchd services and app health for Samara?

The best way to verify launchd service health is to run an automated maintenance check that confirms essential services and Samara.app are active, healthy, and operating without integrity issues.

How do I run a quick health check to see if my system has drift?

Run a quick health check by executing the sync-organism script with the --check flag to verify drift status and output whether drift is detected, all without requiring external installations.

When should I run maintenance checks on my Samara organism?

You should run maintenance checks during initial setup, after system updates, during wake-cycle issues, or on a scheduled basis to detect drift, verify launchd services, and ensure critical integrity checks pass.

Does the maintenance script require any external dependencies or installations?

No, the maintenance script requires zero external dependencies or installations, executing standard shell commands and reading internal system paths to perform drift checks, launchd verification, and self-repair actions.

Why are stale locks and broken symlinks causing issues with my system integrity?

Stale locks and broken symlinks cause reliability issues by disrupting critical system paths, and the maintenance script addresses this by detecting stale locks and verifying critical symlinks during its integrity checks.