rn plan sync
Push local plans to rockstar.ninja. By default, scoped to the current project directory (use --all to sync all projects). Discovers plans and pushes any that are new or have changed since the last push.
rn plan sync
Alias: rn p sync
Behavior
- Discovers plans in
~/.claude/plans/, scoped to the current project (or all projects with--all) - Fetches your remote plan list to identify what's already pushed
- Skips plans that are already synced and unchanged
- Pushes new and locally-changed plans concurrently (4 workers by default)
- Prints a summary when complete
Plans are considered "changed" when the local file's modification time is newer than the remote version's last update. Plans with identical content won't create a new version on the server even if re-pushed.
Flags
| Flag | Short | Type | Description |
|---|---|---|---|
--all |
-a |
bool | Sync plans from all projects |
--concurrency |
-j |
int | Concurrent pushes (default: 4) |
--dry-run |
bool | Show what would be synced without pushing | |
--expires |
string | Expiry duration (e.g., 24h, 7d) |
|
--public |
bool | Make plans publicly visible | |
--secret |
bool | Make plans secret (unlisted) | |
--private |
bool | Make plans private (only you can view) | |
--project |
string | Sync only plans matching this project label | |
--redact |
-R |
string | Literal string to redact (repeatable) |
Privacy and expiration
Same defaults as rn plan push — flags override config, config overrides the global default of secret. See Plan Push for details.
Rate limiting
If the server rate-limits a push (429), the CLI reads the Retry-After header and waits the indicated duration before retrying (up to 3 retries).
Examples
Preview what would be synced:
rn plan sync --dry-run
Sync all plans across all projects:
rn plan sync --all
Sync all plans publicly:
rn plan sync --all --public
Sync with expiration:
rn plan sync --expires 7d --secret