{"id":"7948a0ba-e9ff-46f1-b722-8ee2916ee9fa","entityType":"agent","slug":"clawhub-lyy4916-workbuddy-icloud-sync","name":"workbuddy-icloud-sync","canonicalUrl":"https://www.xpersona.co/agent/clawhub-lyy4916-workbuddy-icloud-sync","canonicalPath":"/agent/clawhub-lyy4916-workbuddy-icloud-sync","generatedAt":"2026-10-09T19:19:47.513Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:44:42.999Z","emptyReason":null},"description":"Set up automatic WorkBuddy config sync across multiple Macs using iCloud Drive. No GitHub account, no token, no SSH key needed — just log into the same iCloud account on all machines. Triggers: iCloud 同步, iCloud 版同步, 不用 GitHub 同步, 苹果云同步 WorkBuddy, iCloud sync WorkBuddy, sync without GitHub. Uses a bare git repo inside iCloud Drive with a background daemon syncing every 5 minutes.","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.6K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s177t5gz1g9bqr9wzdn3k301nh8bn7wz:workbuddy-icloud-sync","sourceUrl":"https://clawhub.ai/lyy4916/workbuddy-icloud-sync","homepage":"https://clawhub.ai/lyy4916/skills/workbuddy-icloud-sync","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/lyy4916/workbuddy-icloud-sync","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/lyy4916/skills/workbuddy-icloud-sync","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":68,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"workbuddy-icloud-sync technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:44:42.999Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:44:42.999Z","emptyReason":null},"stars":null,"forks":null,"downloads":2627,"packageName":null,"latestVersion":"0.1.0","tractionLabel":"2.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:44:42.999Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T12:44:42.999Z","lastCrawledAt":"2026-10-09T12:44:42.999Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T12:44:42.999Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.0","createdAt":"2026-08-01T06:38:36.427Z","changelog":"Initial release: Easily sync WorkBuddy config across Macs using iCloud Drive. - Enables WorkBuddy configuration sync with a bare git repo in iCloud Drive; no GitHub account or keys needed. - Includes setup instructions for primary and additional Macs, with auto-sync via a background daemon every 5 minutes. - Provides detailed comparison between iCloud and GitHub sync options. - Specifies which files are synced and which remain machine-specific or server-side. - Offers terminal aliases and scripts for manual and automated sync. - Adds troubleshooting tips and architecture references.","fileCount":10,"zipByteSize":11169}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s177t5gz1g9bqr9wzdn3k301nh8bn7wz:workbuddy-icloud-sync","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s177t5gz1g9bqr9wzdn3k301nh8bn7wz:workbuddy-icloud-sync` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/lyy4916/workbuddy-icloud-sync before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T19:19:47.512Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-lyy4916-workbuddy-icloud-sync/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:44:42.999Z","emptyReason":null},"readme":"Skill: workbuddy-icloud-sync\n\nOwner: lyy4916\n\nSummary: Set up automatic WorkBuddy config sync across multiple Macs using iCloud Drive. No GitHub account, no token, no SSH key needed — just log into the same iCloud account on all machines. Triggers: iCloud 同步, iCloud 版同步, 不用 GitHub 同步, 苹果云同步 WorkBuddy, iCloud sync WorkBuddy, sync without GitHub. Uses a bare git repo inside iCloud Drive with a background daemon syncing every 5 minutes.\n\nTags: latest:0.1.0\n\nVersion history:\n\nv0.1.0 | 2026-08-01T06:38:36.427Z | auto\n\nInitial release: Easily sync WorkBuddy config across Macs using iCloud Drive.\n\n- Enables WorkBuddy configuration sync with a bare git repo in iCloud Drive; no GitHub account or keys needed.\n- Includes setup instructions for primary and additional Macs, with auto-sync via a background daemon every 5 minutes.\n- Provides detailed comparison between iCloud and GitHub sync options.\n- Specifies which files are synced and which remain machine-specific or server-side.\n- Offers terminal aliases and scripts for manual and automated sync.\n- Adds troubleshooting tips and architecture references.\n\nArchive index:\n\nArchive v0.1.0: 10 files, 11169 bytes\n\nFiles: references (0b), references/gitignore-template (922b), references/sync-architecture-icloud.md (3310b), scripts (0b), scripts/auto-sync-icloud.sh (1227b), scripts/setup-mac-b-icloud.sh (4571b), scripts/start-sync-daemon.sh (1561b), skill-card.md (2845b), SKILL.md (7713b), _meta.json (140b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: workbuddy-icloud-sync\ndescription: \"Set up automatic WorkBuddy config sync across multiple Macs using iCloud Drive. No GitHub account, no token, no SSH key needed — just log into the same iCloud account on all machines. Triggers: iCloud 同步, iCloud 版同步, 不用 GitHub 同步, 苹果云同步 WorkBuddy, iCloud sync WorkBuddy, sync without GitHub. Uses a bare git repo inside iCloud Drive with a background daemon syncing every 5 minutes.\"\nagent_created: true\n---\n\n# WorkBuddy iCloud Sync\n\n## Overview\n\nSynchronize WorkBuddy configuration across multiple Macs using a **bare Git\nrepository stored in iCloud Drive**. No external service required — just log\ninto the same iCloud account on every machine. After setup, identity, memory,\nskills, and settings stay in sync automatically via a background daemon.\n\n## When to Use This vs GitHub Sync\n\n| Factor | iCloud Sync | GitHub Sync |\n|--------|-------------|-------------|\n| Account needed | iCloud (Apple ID) | GitHub account |\n| Network | Apple iCloud (may be slow in China) | GitHub (may need proxy in China) |\n| Token/SSH | Not needed | Personal Access Token or SSH key |\n| Setup complexity | Very simple | Medium |\n| Version history | Yes (git log) | Yes (git log) |\n| Best for | Same Apple ID on all Macs | Different accounts or cross-platform |\n\n## What Syncs vs What Doesn't\n\n### Syncs (via Git)\n- Identity files: `SOUL.md`, `IDENTITY.md`, `USER.md`\n- Memory: `MEMORY.md` (user-level, NOT `memory/` daily logs)\n- Skills: `skills/` directory\n- Config: `mcp.json`, `settings.json`\n- Setup scripts stored in repo\n\n### Does NOT Sync (machine-specific)\n- `binaries/` — 300MB+ platform-specific runtimes\n- `workbuddy.db` — SQLite database (automations, runtime state)\n- `.mcp.json` — localhost port numbers differ per machine\n- `sessions/`, `logs/`, `traces/` — runtime data\n- `credentials/` — each machine logs in independently\n- `memory/` — daily work logs, project-specific\n\n### Already Synced (server-side)\n- Conversation history\n- Cloud user profile (auto-injected at session start)\n\n## Workflow\n\n### Phase 1: Set Up Mac A (Primary Machine)\n\n#### Step 1: Verify iCloud Drive\n\n```bash\n# Check iCloud Drive is available\nls -d ~/Library/Mobile\\ Documents/com~apple~CloudDocs && echo \"ICLOUD_OK\" || echo \"NO_ICLOUD\"\n```\n\nIf `NO_ICLOUD`: System Preferences → Apple ID → iCloud → enable iCloud Drive.\n\n#### Step 2: Initialize Git in `~/.workbuddy/`\n\n```bash\ngit config --global user.name \"$(whoami)\"\ngit config --global user.email \"$(whoami)@workbuddy.local\"\ngit config --global init.defaultBranch main\n\ncd ~/.workbuddy\ngit init\n```\n\n#### Step 3: Create `.gitignore`\n\nCopy `references/gitignore-template` to `~/.workbuddy/.gitignore`.\nThis excludes all machine-specific files (binaries, workbuddy.db, .mcp.json,\nsessions, logs, traces, credentials, memory, daemon state files).\n\n#### Step 4: Create iCloud Bare Repo and Push\n\n```bash\nICLOUD_DIR=\"$HOME/Library/Mobile Documents/com~apple~CloudDocs\"\n\n# Create bare repo in iCloud\ngit clone --bare ~/.workbuddy \"$ICLOUD_DIR/WorkBuddy-sync.git\"\n\n# Add as remote and push\ncd ~/.workbuddy\ngit remote add icloud \"$ICLOUD_DIR/WorkBuddy-sync.git\"\ngit add -A\ngit commit -m \"init: WorkBuddy config from $(hostname)\"\ngit push -u icloud main\n```\n\n#### Step 5: Install Auto-Sync\n\n1. Copy `scripts/auto-sync-icloud.sh` to `~/.workbuddy/auto-sync.sh`\n2. Copy `scripts/start-sync-daemon.sh` to `~/.workbuddy/start-sync-daemon.sh`\n3. Make both executable:\n```bash\nchmod +x ~/.workbuddy/auto-sync.sh ~/.workbuddy/start-sync-daemon.sh\n```\n4. Start the daemon:\n```bash\nosascript -e 'do shell script \"/bin/bash ~/.workbuddy/start-sync-daemon.sh\"'\n```\n\n#### Step 6: Add Terminal Hook\n\nAppend to `~/.bash_profile` (or `~/.zshrc`):\n\n```bash\n# WorkBuddy iCloud 同步快捷命令\nalias wbsync='cd ~/.workbuddy && git add -A && git commit -m \"sync $(date +%m%d-%H%M)\" && git push icloud main'\nalias wbpull='cd ~/.workbuddy && git pull icloud main'\n\n# WorkBuddy 自动同步 — 守护进程保活 + 终端打开时即时同步\nif [ -f ~/.workbuddy/start-sync-daemon.sh ]; then\n  bash ~/.workbuddy/start-sync-daemon.sh 2>/dev/null\nfi\nif [ -t 1 ] && [ -f ~/.workbuddy/auto-sync.sh ]; then\n  _wb_now=$(date +%s)\n  _wb_last=$(cat ~/.workbuddy/.last-auto-sync 2>/dev/null || echo 0)\n  if [ $((_wb_now - _wb_last)) -gt 300 ]; then\n    bash ~/.workbuddy/auto-sync.sh >/dev/null 2>&1 &\n    echo $_wb_now > ~/.workbuddy/.last-auto-sync\n  fi\n  unset _wb_now _wb_last\nfi\n```\n\n#### Step 7: Commit and Push Everything\n\n```bash\ncd ~/.workbuddy\ngit add -A\ngit commit -m \"add: auto-sync scripts + terminal hook\"\ngit push icloud main\n```\n\n### Phase 2: Set Up Mac B (Additional Machines)\n\n#### Prerequisites\n- WorkBuddy installed and launched once (creates `~/.workbuddy/`), then quit\n- **Same iCloud account** logged in, iCloud Drive enabled\n- Wait for iCloud to sync the `WorkBuddy-sync.git` folder (check with\n  `ls ~/Library/Mobile\\ Documents/com~apple~CloudDocs/WorkBuddy-sync.git`)\n\n#### Setup\n\nRun `scripts/setup-mac-b-icloud.sh` on Mac B. Or manually:\n\n```bash\nWB_DIR=\"$HOME/.workbuddy\"\nICLOUD_DIR=\"$HOME/Library/Mobile Documents/com~apple~CloudDocs\"\n\n# Backup existing config\nif [ -f \"$WB_DIR/SOUL.md\" ]; then\n  cp -r \"$WB_DIR\" \"$WB_DIR.backup.$(date +%Y%m%d%H%M%S)\"\nfi\n\n# Configure git\ngit config --global user.name \"$(whoami)\"\ngit config --global user.email \"$(whoami)@workbuddy.local\"\ngit config --global init.defaultBranch main\n\n# Clone from iCloud\ncd \"$WB_DIR\"\nif [ -d \".git\" ]; then\n  git remote remove icloud 2>/dev/null\n  git remote add icloud \"$ICLOUD_DIR/WorkBuddy-sync.git\"\n  git fetch icloud\n  git reset --hard icloud/main\nelse\n  git init\n  git remote add icloud \"$ICLOUD_DIR/WorkBuddy-sync.git\"\n  git fetch icloud\n  git checkout -f -B main icloud/main\nfi\n\n# Make scripts executable\nchmod +x \"$WB_DIR/auto-sync.sh\" \"$WB_DIR/start-sync-daemon.sh\" 2>/dev/null\n\n# Start daemon\nbash \"$WB_DIR/start-sync-daemon.sh\"\n```\n\nThen add the terminal hook from Step 6 to Mac B's `~/.bash_profile`.\n\n### Phase 3: Verification\n\n```bash\n# Check daemon\ncat ~/.workbuddy/.sync-daemon.pid\nkill -0 $(cat ~/.workbuddy/.sync-daemon.pid) && echo \"ALIVE\" || echo \"DEAD\"\n\n# Check sync log\ntail -5 ~/.workbuddy/.auto-sync.log\n\n# Check git\ncd ~/.workbuddy && git log --oneline -3 && git remote -v\n```\n\n## Important Notes\n\n- **iCloud sync latency**: iCloud Drive may take 30-60 seconds to propagate\n  changes between machines. The 5-minute daemon interval is sufficient.\n- **First-time iCloud download**: Mac B must wait for iCloud to fully download\n  the `WorkBuddy-sync.git` folder before cloning. Check with `ls`.\n- **LaunchAgent** (`launchctl load`) often fails with \"Input/output error\" on\n  macOS 12+ under sandbox. The Python subprocess daemon approach is more reliable.\n- **Automations** (scheduled tasks) are stored in `workbuddy.db` and do NOT sync.\n  Recreate them on each machine using the `automation_update` tool.\n- **Project workspace memory** (`<project>/.workbuddy/memory/`) is NOT inside\n  `~/.workbuddy/` and must be synced separately.\n- **Daemon recovery**: After reboot, the daemon restarts when the user opens\n  a terminal or when WorkBuddy runs any bash command.\n- **iCloud storage**: The bare repo is typically < 5 MB. No storage concerns.\n\n## Resources\n\n### scripts/\n- `auto-sync-icloud.sh` — Sync script using `icloud` remote (pull → commit → push)\n- `start-sync-daemon.sh` — Daemon launcher with PID dedup and Python auto-detection\n- `setup-mac-b-icloud.sh` — Mac B one-click setup (clones from iCloud Drive)\n\n### references/\n- `gitignore-template` — The `.gitignore` file for `~/.workbuddy/`\n- `sync-architecture-icloud.md` — Architecture, troubleshooting, and comparison with GitHub\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn751pzj8jbknm4tygdecnwjzn8bmtyz\",\n  \"slug\": \"workbuddy-icloud-sync\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1785566316427\n}\n\nFile v0.1.0:references/sync-architecture-icloud.md\n\n# iCloud Sync Architecture & Troubleshooting\n\n## How It Works\n\n```\nMac A ~/.workbuddy/ → git push → iCloud Drive/WorkBuddy-sync.git (bare repo)\n                                              ↓ (iCloud auto-syncs the file)\nMac B ~/.workbuddy/ ← git pull ← iCloud Drive/WorkBuddy-sync.git (bare repo)\n```\n\niCloud Drive treats the bare git repo as a regular folder. When Mac A pushes,\nthe bare repo files update; iCloud propagates the changes to Mac B's local\niCloud Drive copy; Mac B's daemon then pulls from that local copy.\n\n## Data Layers\n\n### Layer 1: Server-Side Synced (automatic)\n- Conversation history\n- Cloud user profile\n\n### Layer 2: Git-Synced via iCloud (this skill)\n- `SOUL.md`, `IDENTITY.md`, `USER.md`\n- `MEMORY.md`\n- `mcp.json`, `settings.json`\n- `skills/`\n\n### Layer 3: Machine-Local (never synced)\n- `binaries/`, `workbuddy.db`, `.mcp.json`, `sessions/`, `logs/`, `traces/`,\n  `credentials/`, `memory/`\n\n## Daemon Architecture\n\n```\n.bash_profile → start-sync-daemon.sh → Python subprocess → bash loop\n                                                      ↓\n                                              auto-sync.sh (every 300s)\n                                                      ↓\n                                              git pull → commit → push (icloud remote)\n```\n\n## iCloud vs GitHub Comparison\n\n| Aspect | iCloud | GitHub |\n|--------|--------|--------|\n| Account | Apple ID (same on all Macs) | GitHub account |\n| Auth | None (local file access) | Token or SSH key |\n| Network | Apple iCloud | GitHub.com |\n| China speed | Moderate (Apple CDN) | Slow (needs proxy) |\n| Setup time | ~2 minutes | ~5 minutes |\n| Concurrent access | Safe (iCloud serializes file writes) | Safe (git protocol) |\n| Storage limit | iCloud Drive quota (5GB free) | GitHub repo limit |\n| Best for | All Macs share Apple ID | Different Apple IDs or need web access |\n\n## Common Issues\n\n### iCloud hasn't synced the bare repo yet\n**Symptom**: Mac B can't find `WorkBuddy-sync.git` in iCloud Drive\n**Fix**: On Mac A, verify the push succeeded. On Mac B, open Finder → iCloud\nDrive and check if the folder appears. Force iCloud sync:\n```bash\nkillall bird && killall cloudd  # restart iCloud daemons\n```\n\n### Merge conflicts during auto-sync\n**Symptom**: `git pull --rebase` fails\n**Fix**:\n```bash\ncd ~/.workbuddy\ngit status\n# resolve conflicts...\ngit add -A\ngit rebase --continue\ngit push icloud main\n```\n\n### Daemon not running\n**Check**:\n```bash\ncat ~/.workbuddy/.sync-daemon.pid\nkill -0 $(cat ~/.workbuddy/.sync-daemon.pid) && echo \"ALIVE\" || echo \"DEAD\"\n```\n**Restart**:\n```bash\nbash ~/.workbuddy/start-sync-daemon.sh\n```\n\n### Switching from GitHub to iCloud\n```bash\ncd ~/.workbuddy\ngit remote remove origin 2>/dev/null\ngit remote add icloud \"$HOME/Library/Mobile Documents/com~apple~CloudDocs/WorkBuddy-sync.git\"\ngit push -u icloud main\n```\nThen update `auto-sync.sh` to use `icloud` remote instead of `origin`.\n\n### Automations not syncing\nAutomations live in `workbuddy.db` (excluded from sync). Recreate on each\nmachine using the `automation_update` tool.\n\n## Daemon Recovery After Reboot\nThe daemon dies on reboot but auto-restarts when:\n1. User opens Terminal (`.bash_profile` calls `start-sync-daemon.sh`)\n2. WorkBuddy executes any bash command (triggers `.bash_profile`)\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nSet up automatic WorkBuddy config sync across multiple Macs using iCloud Drive, using a bare git repository in iCloud Drive and a background daemon that syncs every 5 minutes.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[lyy4916](https://clawhub.ai/user/lyy4916)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and WorkBuddy users use this skill to set up iCloud Drive based configuration sync across trusted Macs on the same Apple ID. It provides setup guidance, shell commands, helper scripts, and troubleshooting notes for synchronizing selected WorkBuddy identity, memory, skill, and settings files while leaving machine-local data out of sync.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Persistent background syncing can silently propagate WorkBuddy configuration and skill changes across Macs.\n\nMitigation: Install only on trusted Macs using the same intended iCloud account, review the profile hook and daemon scripts before enabling them, and remove the profile hook and daemon state to stop automatic sync.\n\nRisk: Setup on an additional Mac can overwrite local WorkBuddy configuration.\n\nMitigation: Back up ~/.workbuddy before setup and review git status, pull, reset, and push behavior before running the setup script.\n\nRisk: Unintended files may sync if exclusions are incomplete or modified.\n\nMitigation: Review the provided .gitignore template and confirm credentials, runtime state, databases, logs, sessions, and machine-specific files remain excluded before the first push.\n\nRisk: The scripts can alter global Git settings when user.name or user.email is unset.\n\nMitigation: Check existing Git configuration before installation and update it manually if the generated WorkBuddy-local identity is not appropriate.\n\n## Reference(s):\n\n- [Server-resolved GitHub source](https://github.com/lyy4916/workbuddy-icloud-sync)\n- [ClawHub skill page](https://clawhub.ai/lyy4916/skills/workbuddy-icloud-sync)\n- [iCloud sync architecture and troubleshooting](references/sync-architecture-icloud.md)\n- [WorkBuddy sync gitignore template](references/gitignore-template)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with inline bash command blocks and bundled shell scripts]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Targets macOS systems using WorkBuddy, Git, iCloud Drive, and a background sync daemon.]\n\n## Skill Version(s):\n\n0.1.0 (source: release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.","readmeExcerpt":"Skill: workbuddy-icloud-sync Owner: lyy4916 Summary: Set up automatic WorkBuddy config sync across multiple Macs using iCloud Drive. No GitHub account, no token, no SSH key needed — just log into the same iCloud account on all machines. Triggers: iCloud 同步, iCloud 版同步, 不用 GitHub 同步, 苹果云同步 WorkBuddy, iCloud sync WorkBuddy, sync without GitHub. Uses a bare git repo inside iCloud Drive with a background daemon syncing e","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Check iCloud Drive is available\nls -d ~/Library/Mobile\\ Documents/com~apple~CloudDocs && echo \"ICLOUD_OK\" || echo \"NO_ICLOUD\""},{"language":"bash","snippet":"git config --global user.name \"$(whoami)\"\ngit config --global user.email \"$(whoami)@workbuddy.local\"\ngit config --global init.defaultBranch main\n\ncd ~/.workbuddy\ngit init"},{"language":"bash","snippet":"ICLOUD_DIR=\"$HOME/Library/Mobile Documents/com~apple~CloudDocs\"\n\n# Create bare repo in iCloud\ngit clone --bare ~/.workbuddy \"$ICLOUD_DIR/WorkBuddy-sync.git\"\n\n# Add as remote and push\ncd ~/.workbuddy\ngit remote add icloud \"$ICLOUD_DIR/WorkBuddy-sync.git\"\ngit add -A\ngit commit -m \"init: WorkBuddy config from $(hostname)\"\ngit push -u icloud main"},{"language":"bash","snippet":"chmod +x ~/.workbuddy/auto-sync.sh ~/.workbuddy/start-sync-daemon.sh"},{"language":"bash","snippet":"osascript -e 'do shell script \"/bin/bash ~/.workbuddy/start-sync-daemon.sh\"'"},{"language":"bash","snippet":"# WorkBuddy iCloud 同步快捷命令\nalias wbsync='cd ~/.workbuddy && git add -A && git commit -m \"sync $(date +%m%d-%H%M)\" && git push icloud main'\nalias wbpull='cd ~/.workbuddy && git pull icloud main'\n\n# WorkBuddy 自动同步 — 守护进程保活 + 终端打开时即时同步\nif [ -f ~/.workbuddy/start-sync-daemon.sh ]; then\n  bash ~/.workbuddy/start-sync-daemon.sh 2>/dev/null\nfi\nif [ -t 1 ] && [ -f ~/.workbuddy/auto-sync.sh ]; then\n  _wb_now=$(date +%s)\n  _wb_last=$(cat ~/.workbuddy/.last-auto-sync 2>/dev/null || echo 0)\n  if [ $((_wb_now - _wb_last)) -gt 300 ]; then\n    bash ~/.workbuddy/auto-sync.sh >/dev/null 2>&1 &\n    echo $_wb_now > ~/.workbuddy/.last-auto-sync\n  fi\n  unset _wb_now _wb_last\nfi"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: workbuddy-icloud-sync\ndescription: \"Set up automatic WorkBuddy config sync across multiple Macs using iCloud Drive. No GitHub account, no token, no SSH key needed — just log into the same iCloud account on all machines. Triggers: iCloud 同步, iCloud 版同步, 不用 GitHub 同步, 苹果云同步 WorkBuddy, iCloud sync WorkBuddy, sync without GitHub. Uses a bare git repo inside iCloud Drive with a background daemon syncing every 5 minutes.\"\nagent_created: true\n---\n\n# WorkBuddy iCloud Sync\n\n## Overview\n\nSynchronize WorkBuddy configuration across multiple Macs using a **bare Git\nrepository stored in iCloud Drive**. No external service required — just log\ninto the same iCloud account on every machine. After setup, identity, memory,\nskills, and settings stay in sync automatically via a background daemon.\n\n## When to Use This vs GitHub Sync\n\n| Factor | iCloud Sync | GitHub Sync |\n|--------|-------------|-------------|\n| Account needed | iCloud (Apple ID) | GitHub account |\n| Network | Apple iCloud (may be slow in China) | GitHub (may need proxy in China) |\n| Token/SSH | Not needed | Personal Access Token or SSH key |\n| Setup complexity | Very simple | Medium |\n| Version history | Yes (git log) | Yes (git log) |\n| Best for | Same Apple ID on all Macs | Different accounts or cross-platform |\n\n## What Syncs vs What Doesn't\n\n### Syncs (via Git)\n- Identity files: `SOUL.md`, `IDENTITY.md`, `USER.md`\n- Memory: `MEMORY.md` (user-level, NOT `memory/` daily logs)\n- Skills: `skills/` directory\n- Config: `mcp.json`, `settings.json`\n- Setup scripts stored in repo\n\n### Does NOT Sync (machine-specific)\n- `binaries/` — 300MB+ platform-specific runtimes\n- `workbuddy.db` — SQLite database (automations, runtime state)\n- `.mcp.json` — localhost port numbers differ per machine\n- `sessions/`, `logs/`, `traces/` — runtime data\n- `credentials/` — each machine logs in independently\n- `memory/` — daily work logs, project-specific\n\n### Already Synced (server-side)\n- Conversation history\n- Cloud user profile (auto-injected at session start)\n\n## Workflow\n\n### Phase 1: Set Up Mac A (Primary Machine)\n\n#### Step 1: Verify iCloud Drive\n\n```bash\n# Check iCloud Drive is available\nls -d ~/Library/Mobile\\ Documents/com~apple~CloudDocs && echo \"ICLOUD_OK\" || echo \"NO_ICLOUD\"\n```\n\nIf `NO_ICLOUD`: System Preferences → Apple ID → iCloud → enable iCloud Drive.\n\n#### Step 2: Initialize Git in `~/.workbuddy/`\n\n```bash\ngit config --global user.name \"$(whoami)\"\ngit config --global user.email \"$(whoami)@workbuddy.local\"\ngit config --global init.defaultBranch main\n\ncd ~/.workbuddy\ngit init\n```\n\n#### Step 3: Create `.gitignore`\n\nCopy `references/gitignore-template` to `~/.workbuddy/.gitignore`.\nThis excludes all machine-specific files (binaries, workbuddy.db, .mcp.json,\nsessions, logs, traces, credentials, memory, daemon state files).\n\n#### Step 4: Create iCloud Bare Repo and Push\n\n```bash\nICLOUD_DIR=\"$HOME/Library/Mobile Documents/com~apple~CloudDocs\"\n\n# Create bare repo in iCloud\ngit clone --bare ~/.workbuddy \"$"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn751pzj8jbknm4tygdecnwjzn8bmtyz\",\n  \"slug\": \"workbuddy-icloud-sync\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1785566316427\n}"},{"path":"references/sync-architecture-icloud.md","content":"# iCloud Sync Architecture & Troubleshooting\n\n## How It Works\n\n```\nMac A ~/.workbuddy/ → git push → iCloud Drive/WorkBuddy-sync.git (bare repo)\n                                              ↓ (iCloud auto-syncs the file)\nMac B ~/.workbuddy/ ← git pull ← iCloud Drive/WorkBuddy-sync.git (bare repo)\n```\n\niCloud Drive treats the bare git repo as a regular folder. When Mac A pushes,\nthe bare repo files update; iCloud propagates the changes to Mac B's local\niCloud Drive copy; Mac B's daemon then pulls from that local copy.\n\n## Data Layers\n\n### Layer 1: Server-Side Synced (automatic)\n- Conversation history\n- Cloud user profile\n\n### Layer 2: Git-Synced via iCloud (this skill)\n- `SOUL.md`, `IDENTITY.md`, `USER.md`\n- `MEMORY.md`\n- `mcp.json`, `settings.json`\n- `skills/`\n\n### Layer 3: Machine-Local (never synced)\n- `binaries/`, `workbuddy.db`, `.mcp.json`, `sessions/`, `logs/`, `traces/`,\n  `credentials/`, `memory/`\n\n## Daemon Architecture\n\n```\n.bash_profile → start-sync-daemon.sh → Python subprocess → bash loop\n                                                      ↓\n                                              auto-sync.sh (every 300s)\n                                                      ↓\n                                              git pull → commit → push (icloud remote)\n```\n\n## iCloud vs GitHub Comparison\n\n| Aspect | iCloud | GitHub |\n|--------|--------|--------|\n| Account | Apple ID (same on all Macs) | GitHub account |\n| Auth | None (local file access) | Token or SSH key |\n| Network | Apple iCloud | GitHub.com |\n| China speed | Moderate (Apple CDN) | Slow (needs proxy) |\n| Setup time | ~2 minutes | ~5 minutes |\n| Concurrent access | Safe (iCloud serializes file writes) | Safe (git protocol) |\n| Storage limit | iCloud Drive quota (5GB free) | GitHub repo limit |\n| Best for | All Macs share Apple ID | Different Apple IDs or need web access |\n\n## Common Issues\n\n### iCloud hasn't synced the bare repo yet\n**Symptom**: Mac B can't find `WorkBuddy-sync.git` in iCloud Drive\n**Fix**: On Mac A, verify the push succeeded. On Mac B, open Finder → iCloud\nDrive and check if the folder appears. Force iCloud sync:\n```bash\nkillall bird && killall cloudd  # restart iCloud daemons\n```\n\n### Merge conflicts during auto-sync\n**Symptom**: `git pull --rebase` fails\n**Fix**:\n```bash\ncd ~/.workbuddy\ngit status\n# resolve conflicts...\ngit add -A\ngit rebase --continue\ngit push icloud main\n```\n\n### Daemon not running\n**Check**:\n```bash\ncat ~/.workbuddy/.sync-daemon.pid\nkill -0 $(cat ~/.workbuddy/.sync-daemon.pid) && echo \"ALIVE\" || echo \"DEAD\"\n```\n**Restart**:\n```bash\nbash ~/.workbuddy/start-sync-daemon.sh\n```\n\n### Switching from GitHub to iCloud\n```bash\ncd ~/.workbuddy\ngit remote remove origin 2>/dev/null\ngit remote add icloud \"$HOME/Library/Mobile Documents/com~apple~CloudDocs/WorkBuddy-sync.git\"\ngit push -u icloud main\n```\nThen update `auto-sync.sh` to use `icloud` remote instead of `origin`.\n\n### Automations not syncing\nAutomations live in `workbuddy.db` (excluded from syn"},{"path":"skill-card.md","content":"## Description:\n\nSet up automatic WorkBuddy config sync across multiple Macs using iCloud Drive, using a bare git repository in iCloud Drive and a background daemon that syncs every 5 minutes.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[lyy4916](https://clawhub.ai/user/lyy4916)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and WorkBuddy users use this skill to set up iCloud Drive based configuration sync across trusted Macs on the same Apple ID. It provides setup guidance, shell commands, helper scripts, and troubleshooting notes for synchronizing selected WorkBuddy identity, memory, skill, and settings files while leaving machine-local data out of sync.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Persistent background syncing can silently propagate WorkBuddy configuration and skill changes across Macs.\n\nMitigation: Install only on trusted Macs using the same intended iCloud account, review the profile hook and daemon scripts before enabling them, and remove the profile hook and daemon state to stop automatic sync.\n\nRisk: Setup on an additional Mac can overwrite local WorkBuddy configuration.\n\nMitigation: Back up ~/.workbuddy before setup and review git status, pull, reset, and push behavior before running the setup script.\n\nRisk: Unintended files may sync if exclusions are incomplete or modified.\n\nMitigation: Review the provided .gitignore template and confirm credentials, runtime state, databases, logs, sessions, and machine-specific files remain excluded before the first push.\n\nRisk: The scripts can alter global Git settings when user.name or user.email is unset.\n\nMitigation: Check existing Git configuration before installation and update it manually if the generated WorkBuddy-local identity is not appropriate.\n\n## Reference(s):\n\n- [Server-resolved GitHub source](https://github.com/lyy4916/workbuddy-icloud-sync)\n- [ClawHub skill page](https://clawhub.ai/lyy4916/skills/workbuddy-icloud-sync)\n- [iCloud sync architecture and troubleshooting](references/sync-architecture-icloud.md)\n- [WorkBuddy sync gitignore template](references/gitignore-template)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with inline bash command blocks and bundled shell scripts]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Targets macOS systems using WorkBuddy, Git, iCloud Drive, and a background sync daemon.]\n\n## Skill Version(s):\n\n0.1.0 (source: release metadata)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1347,"uniquenessScore":42,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:44:42.999Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:44:42.999Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T19:19:47.513Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}