SCode OS
Open dashboard

Documentation / Skills sync

Keep every agent on the same skill library.

View source

Use a private Git repository to synchronize ~/.agents between a development VPS and your computer. Both machines run the same small, auditable worker.

Choose where to start

Configure the VPS first when it already contains your canonical skills. Then connect your local machine without overwriting local-only work.

Set up the VPSPublish the current ~/.agents library and start the systemd timer.Set up your computerClone the shared library and schedule synchronization on macOS.

How synchronization works

VPS~/.agents
push / pull
Private Git repositorymain branch
push / pull
Your computer~/.agents
  • Local changes are committed before pulling remote updates.
  • Pulls use rebase so the shared history stays linear and reviewable.
  • A directory lock prevents two workers from running at once.
  • Conflicts stop the worker without discarding either side.

Only the skill library is synchronized.

Project repositories, Code OS configuration, Cloudflare tokens, dashboard credentials, screenshots, and media bypass keys stay machine-local.