Skills
.Work. You
Rest

samara

Community

Debug, check, or restart Samara.app.

Software Engineering#debugging#logs#macOS#restart#FDA#samara
Authorclaudeaceae
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Samara Debug and Control helps you diagnose and repair Samara.app, the macOS message broker that connects iMessage to Claude. It surfaces how to verify it is running, view logs, check Full Disk Access, and perform a safe restart.

Core Features & Use Cases

  • Check if Samara is running and collect status
  • View and analyze logs for debugging
  • Verify FDA status and code signature
  • Restart or reset Samara to restore messaging reliability
  • Use Case: When messages fail to be detected, use this skill to confirm process health and perform controlled restarts.

Quick Start

  • Check if Samara is running: launchctl list co.organelle.Samara 2>/dev/null | grep -E "PID|Label" ps aux | grep -i [S]amara
  • Restart Samara: pkill -f Samara sleep 2 open /Applications/Samara.app
  • Check Full Disk Access (FDA) and signature: ls ~/Library/Messages/chat.db && echo "FDA: OK" || echo "FDA: MISSING" codesign -d -r- /Applications/Samara.app 2>&1 | head -5
  • Validate code signing: codesign -d -r- /Applications/Samara.app 2>&1 | grep "subject.OU"

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: samara
Download link: https://github.com/claudeaceae/samara-main/archive/main.zip#samara

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.