rn session sync
Push local sessions to rockstar.ninja. By default, discovery runs across all available providers and pushes any sessions that are new or changed since the last push.
rn session sync
Alias: rn s sync
Behavior
- Discovers local sessions from available providers (or a specific provider with
--provider) - Fetches your remote session list to identify what's already pushed
- Skips sessions that are already synced and unchanged
- Pushes new and locally-changed sessions concurrently (4 workers by default)
- Prints a summary when complete
Sessions are considered "changed" when the local file's modification time is newer than the remote version's last update.
Flags
| Flag | Short | Type | Description |
|---|---|---|---|
--all |
-a |
bool | Sync sessions 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) |
|
--provider |
-P |
string | Restrict sync to a provider (for example claude, copilot) |
--public |
bool | Make sessions publicly visible | |
--secret |
bool | Make sessions secret (unlisted) | |
--private |
bool | Make sessions private (only you can view) | |
--redact |
-R |
string | Literal string to redact (repeatable) |
Privacy and expiration
Same defaults as rn session push — flags override config, config overrides the global default of secret. See Session Push for details.
Redaction
Client-side redaction rules from your config are applied to every session before upload. Ad-hoc patterns can be added with --redact / -R. See Session 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 session sync --dry-run
Sync all sessions across all projects:
rn session sync --all
Sync with public privacy and 30-day expiry:
rn session sync --public --expires 30d