prime-sync

Ultrathink.

Mode Detection

Detect operating mode before anything else:

1. VERSION file exists in CWD → push mode (CWD is the prime repo)
2. .claude/.prime-version exists in CWD → pull mode (CWD is a target project)
3. Neither detected → ask user which mode and for the required path

Push Mode — Resolve Target

Source = CWD (prime repo). Target = resolved project path.

State file: .claude/prime-projects.json

Tracks known target paths, last sync time, and version. Shape:

{ "projects": [{ "path": "/absolute/path", "lastSynced": "2025-12-30T10:30:00Z", "version": "1.4.2" }] }

Create as { "projects": [] } if missing.

Resolution flow:

1. Argument provided → Use that path, then record it after a successful sync
2. No argument, known projects exist → Ask the user which project(s) to sync, including an All projects option
3. No argument, no known projects → Ask the user for a path

State file management:

• Create .claude/ only if you need to persist the state file
• Update the synced project's time/version only after a successful sync
• Keep one entry per absolute path

Pull Mode — Clone Prime

Source = cloned prime repo. Target = CWD.

Flow:

1. Read current version from .claude/.prime-version in CWD
2. Generate timestamp: date +%Y%m%d%H%M%S
3. Clone prime repo: git clone https://github.com/avibebuilder/claude-prime.git /tmp/claude-prime-sync-<timestamp>/
4. Set source = /tmp/claude-prime-sync-<timestamp>/, target = CWD
5. Continue to shared process below
6. Clean up /tmp/claude-prime-sync-<timestamp>/ after sync completes (success or failure)

No state file in pull mode — the target project is self-contained.

Process

1. Validate Target

• Check that the target path exists, is a directory, and is not the same location as the source repo
• Treat a valid target as a project root where writing .claude/ is appropriate
• Read versions from target (.claude/.prime-version) and prime (VERSION)