claudeaceae/.claude/skills/samara
.claude/skills/samara/SKILL.md
--- name: samara description: Debug, check, or restart Samara.app - the message broker. Use when messages aren't being detected, Samara crashed, need to view logs, check Full Disk Access, or restart the app. Trigger words: samara, messages not working, restart, logs, FDA, broker. context: fork allowed-tools: - Bash - Read - Grep - Glob - Write hooks: PreToolUse: - matcher: "Bash" hooks: - type: command command: "/Users/claude/Developer/samara-main/.claude/
$ install --global
skillsauthnpx skillsauth add claudeaceae/samara-main .claude/skills/samaraInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:50 PM1.8s1 file scanned
SKILL.md
- name:
- samara
- description:
- Debug, check, or restart Samara.app - the message broker. Use when messages aren't being detected, Samara crashed, need to view logs, check Full Disk Access, or restart the app. Trigger words: samara, messages not working, restart, logs, FDA, broker.
- context:
- fork
- - matcher:
- Bash
- - type:
- command
- command:
- /Users/claude/Developer/samara-main/.claude/hooks/block-deriveddata-copy.sh
- timeout:
- 5
Samara Debug and Control
Diagnose and manage Samara.app, the message broker that connects iMessage to Claude.
Quick Actions
Check if Running
launchctl list co.organelle.Samara 2>/dev/null | grep -E "PID|Label"
ps aux | grep -i [S]amara
View Recent Logs
# Samara's own logs
tail -50 ~/.claude-mind/system/logs/samara.log 2>/dev/null
# System logs for Samara
log show --predicate 'process == "Samara"' --last 5m 2>/dev/null | tail -30
Restart Samara
# Kill if running
pkill -f Samara
# Wait a moment
sleep 2
# Relaunch
open /Applications/Samara.app
Tip: This sequence is a good candidate for the Bash subagent (Task tool with subagent_type=Bash) to avoid polluting context with intermediate steps.
Check Full Disk Access
# This will work if FDA is granted
ls ~/Library/Messages/chat.db && echo "FDA: OK" || echo "FDA: MISSING"
# Check code signature (Team ID must be stable)
codesign -d -r- /Applications/Samara.app 2>&1 | head -5
Common Issues
Messages Not Being Detected
- Check Samara is running
- Check FDA is intact
- Check chat.db is readable
- Look for errors in logs
Samara Crashed
- Check system logs for crash reason
- Restart with
open /Applications/Samara.app - If repeated crashes, may need rebuild
FDA Revoked After Update
This happens if Team ID changed during rebuild:
# Check current signature - MUST show G4XVD3J52J
codesign -d -r- /Applications/Samara.app 2>&1 | grep "subject.OU"
# If shows 7V9XLQ8YNQ or any other team: WRONG CERTIFICATE USED
# Must rebuild properly and re-grant FDA
Rebuild Samara
CRITICAL: ONLY use the update-samara script. NEVER copy from DerivedData.
A Claude instance previously broke FDA by copying a Debug build from
~/Library/Developer/Xcode/DerivedData/. This used automatic signing which picked the WRONG certificate and revoked all permissions.
The ONLY correct way to rebuild:
~/.claude-mind/system/bin/update-samara
FORBIDDEN (will break FDA):
cp -R ~/Library/Developer/Xcode/DerivedData/.../Samara.app /Applications/xcodebuild -configuration Debugfor deployment- Any manual copy of Samara.app to /Applications
Verify after rebuild:
codesign -d -r- /Applications/Samara.app 2>&1 | grep "subject.OU"
# Must show: G4XVD3J52J
# If shows: 7V9XLQ8YNQ - WRONG! FDA will be revoked
Diagnostic Report
When troubleshooting, gather:
- Is Samara running?
- FDA status
- Recent log errors
- Last successful message detection
- Code signature validity
Present findings clearly with recommended actions.
Related Skills
For specific issues, use these specialized skills:
/diagnose-leaks— Debug thinking traces or session IDs leaking into messages/debug-session— Debug session management, batching, and task routing/status— Quick system health check
Related Skills
claudeaceae/.claude/skills/webhook
development
VerifiedTrustedCommunity
# /webhook --- name: webhook description: Manage webhook sources - list, add, test, and view incoming events context: fork triggers: - webhook - add webhook - create webhook - webhook setup - incoming webhooks --- Manage the webhook receiver system. Use this skill to add new webhook sources, test existing ones, and view incoming events. ## What You Can Do 1. **List sources** - Show all registered webhook sources 2. **Add source** - Create a new webhook source with secure secret 3.
9SKILL.mdUpdated Apr 16, 2026
claudeaceae/wallet
testing
VerifiedTrustedCommunity
Check crypto wallet balances, transaction history, and addresses
9SKILL.mdUpdated Apr 16, 2026
claudeaceae/.claude/skills/voice-call
testing
VerifiedTrustedCommunity
# /voice-call - FaceTime Voice Calling Place and receive FaceTime Audio calls with live transcription and voice/text responses. ## Quick Start ```bash # Full voice conversation (responds via FaceTime audio) ~/.claude-mind/system/bin/voice-call --voice-response # Call with text responses (via iMessage) ~/.claude-mind/system/bin/voice-call --text-response # Call a specific number ~/.claude-mind/system/bin/voice-call +15551234567 --voice-response ``` ## Prerequisites Run `audio-setup --check
9SKILL.mdUpdated Apr 16, 2026
claudeaceae/.claude/skills/sync
tools
VerifiedTrustedCommunity
--- name: sync description: Check for drift between repo and running system. Use when checking if scripts or Samara are out of sync, verifying system integrity, or before/after rebuilds. Trigger words: sync, organism sync, check drift, system drift, repo sync. context: fork allowed-tools: - Bash - Read - Grep --- # Sync Skill Check for drift between the repo and running system, and optionally fix it. ## What This Does Runs the `sync-organism` script to detect differences between: - `~/
9SKILL.mdUpdated Apr 16, 2026