← ClaudeAtlas

sync-env-downlisted

Pull the unified Claude environment (memory, plans, settings, skills, secrets) DOWN from the shared sync folder onto this machine, overwriting/updating local with the latest. Use when the user types /sync-env-down or says they just sat down at this machine and want to bring over the environment they were working on elsewhere / pull the latest from the sync folder. Always previews changes and confirms before any destructive deletion; never clobbers newer local work without flagging a conflict.
JonMcMillan/claude-sync-by-skill · ★ 0 · AI & Automation · score 72
Install: claude install-skill JonMcMillan/claude-sync-by-skill
# sync-env-down — pull sync folder → local Brings the unified environment onto this machine. The engine (`sync_engine.py`) lives in the sibling `sync-envs` skill folder. ## How to run the engine - **Windows:** `py -3 "<claudeSkillsDir>\sync-envs\sync_engine.py" <args>` - **macOS/Linux:** `python3 "<claudeSkillsDir>/sync-envs/sync_engine.py" <args>` **Always launch it in the background** (the Bash tool's `run_in_background: true`), for both previews and applies. The sync folder is usually a cloud drive, and when the drive client is unwell the engine blocks in a kernel filesystem read for minutes. A foreground run holds the whole turn hostage, so the user cannot ask you to investigate while it hangs — which is exactly when they most want to. Backgrounding costs nothing on a fast run (you are notified as soon as it exits) and keeps you reachable on a slow one. ## The 30-second check (do this every run) A healthy scan reaches its first output within a few seconds. So: **if the run has not finished at ~30 seconds, check on it — do not keep waiting.** The engine emits a heartbeat to **stderr** while scanning: ``` [scan] claude-memory (down): 1840 files ``` Read the background output at ~30s, then again ~10s later, and compare: - **Line count/counter advancing** → healthy, just large. Say so and keep waiting. - **Last `[scan]` line identical across both samples** → **stalled. Raise the alarm now** (see below). The last line also names the phase it wedged in. - **No `[sca