Skip to main content
You code on your work laptop during the day. You hack on side projects from your desktop at home. You occasionally use your old MacBook when traveling. Problem: Your repr stories are scattered across three machines. You can’t remember which computer has which stories. Solution: Multi-device sync. Sign in to the same account on all your devices, and repr keeps everything synchronized via the cloud.

​
The Setup: Adding a New Device

Let’s say you’ve been using repr on your work laptop. Now you want to add your home desktop.
1

Install repr on the new device

Same as always:
2

Initialize with your local repos

Point repr at your code folder:
This scans for git repositories on this machine. They don’t have to be the same repos as your other device—repr is smart about merging stories from different repos.
3

Sign in with your existing account

Use the same account you use on your other device:
This opens your browser for device flow authentication (no password in the terminal). Sign in, and you’re connected.
4

Pull your existing stories

Download all the stories from your other device(s):
Output:
Now your home desktop has all the stories you generated on your work laptop. Magic.

​
The Daily Workflow: Staying in Sync

Once all your devices are connected to the same account, here’s how to keep them synchronized. Start your day by pulling the latest:
Do your work. Generate stories. When you’re done for the day:
Or do both at once:
Output:

​
Option 2: Automatic Sync with Git Hooks

You can hook repr sync into your git workflow. Add this to your shell config:
Now when you pull/push code, your stories sync too. Convenient.

​
Option 3: Scheduled Sync (Advanced)

Want it completely automatic? Add a cron job or launchd service:
Now your stories sync in the background. You don’t have to think about it.

​
Handling Conflicts

Repr is pretty smart about conflicts, but occasionally you’ll edit the same story on two devices before syncing.

​
The Default Strategy: Last Write Wins

If you edit story 01ABC... on your laptop and the same story on your desktop, repr uses the most recent edit when you sync. You’ll see a warning:
Your local version is saved to ~/.repr/conflicts/ just in case.

​
Check Sync Status

Want to see what will happen before syncing?
Output:

​
Preview Before Pushing

Always a good idea:
Output:

​
Multiple Repos Across Devices

Here’s where it gets really powerful: You don’t need the same repos on all devices. Work laptop tracks:
  • ~/work/api-service
  • ~/work/frontend-app
  • ~/work/infrastructure
Home desktop tracks:
  • ~/code/side-project
  • ~/code/open-source-contribution
  • ~/code/personal-site
When you sync, repr merges stories from all repos across all devices. Your profile becomes a complete picture of everything you build, everywhere.

​
The Multi-Device Power Move

Here’s a workflow that really works:
  1. Work laptop: Set up hooks, generate stories automatically during the week
  2. Friday afternoon: Run repr push from your work laptop
  3. Weekend: Pull to your home desktop with repr pull
  4. Review and curate: Polish stories, feature the best ones, export summaries
  5. Sunday night: Push curated stories back with repr push
  6. Monday morning: Pull to work laptop, your profile is polished and ready
Your stories flow between devices. You generate on one, curate on another, publish from either.

​
Selective Sync (Advanced)

Don’t want to sync everything? You can be selective:

​
Troubleshooting Sync Issues

​
”Auth token expired”

Your login expired. Re-authenticate:

​
“Conflict detected”

You edited the same story on multiple devices. Check the conflict directory:
Pick the version you want and manually restore it.

​
”Sync failed: Network error”

Repr couldn’t reach repr.dev. Check your connection:

​
“Stories out of sync”

Force a full sync:
This re-downloads everything from the cloud and reconciles local stories.

​
Privacy Note: What Gets Synced?

Let’s be clear about what syncing means: What gets synced:
  • ✅ Your generated stories (titles, narratives, metadata)
  • ✅ Story edits and curation (featured/hidden status)
  • ✅ Profile settings (bio, location, availability)
What doesn’t get synced:
  • ❌ Your source code (never)
  • ❌ Commit diffs (never)
  • ❌ Repository contents (never)
  • ❌ Git history (never)
Syncing uploads your stories (the LLM-generated narratives), not your code.

​
When Multi-Device Sync Makes Sense

Good fit:
  • You code on 2+ computers regularly
  • You want a unified view of all your work
  • You’re comfortable with cloud sync
Not necessary if:
  • You only code on one machine
  • You prefer full local-only mode
  • You manually export/import as needed
Multi-device sync is optional. Repr works great on a single device too.

​
What’s Next?

Once you’ve got sync working:
  • Weekly ritual: Pull → Review → Feature → Push
  • Publishing: Your stories are already synced, just run repr push --all to make your profile public
  • Backup: Even with sync, run repr data backup occasionally for local backups
Sync gives you flexibility. Work from anywhere, your stories follow you.