Code Sync

Synchronize configuration between your local environment and systemprompt.io Cloud. Keep skills, agents, content, and MCP servers in sync across environments.

Sync Overview

┌─────────────────────┐                    ┌─────────────────────┐
│       LOCAL         │                    │        CLOUD        │
│                     │      push          │                     │
│  services/          │  ─────────────▶    │  Cloud Database     │
│  ├── agents/        │                    │  ├── agents         │
│  ├── skills/        │      pull          │  ├── skills         │
│  ├── mcp/           │  ◀─────────────    │  ├── mcp_servers    │
│  └── content/       │                    │  └── content        │
└─────────────────────┘                    └─────────────────────┘

Push Local to Cloud

Push your local state to the cloud tenant:

# Push local state to cloud
systemprompt cloud sync push

# Preview first
systemprompt cloud sync push --dry-run

Pull Cloud to Local

Pull cloud state to your local environment:

# Pull cloud state to local
systemprompt cloud sync pull

# Preview first
systemprompt cloud sync pull --dry-run

Local Files to Database

There is no separate local sync command. Local YAML under services/ is bootstrap configuration: it is ingested into the local database when the server starts. Edit the files, then restart the server (just start) to pick up changes. The database owns runtime state.

What Gets Synced

Type	Local Path	Description
Agents	services/agents/*.yaml	Agent definitions and A2A cards
Skills	services/skills/*.yaml	Skill definitions
MCP Servers	services/mcp/*.yaml	MCP server configurations
Content	services/content/**/*.md	Blog posts, documentation

Conflict Resolution

When local and cloud versions differ:

# Preview changes before sync
systemprompt cloud sync push --dry-run

# Force local to override cloud
systemprompt cloud sync push --force

# Force cloud to override local
systemprompt cloud sync pull --force

Conflict Strategies

Strategy	Flag	Behavior
Preview	--dry-run	Show diff without changes
Local wins	push --force	Overwrite cloud with local
Cloud wins	pull --force	Overwrite local with cloud
Merge	Default	Fail on conflict, require resolution

Dry Run Mode

Preview what would be synced without making changes:

# See what would be pushed
systemprompt cloud sync push --dry-run --verbose

# See what would be pulled
systemprompt cloud sync pull --dry-run --verbose

Sync the Admin User

Sync your cloud user as an admin into all local profiles:

systemprompt cloud sync admin-user

Troubleshooting

Issue	Cause	Solution
Auth error	Session expired	Run systemprompt cloud auth login
Conflict	Local and cloud differ	Use --dry-run to compare, then --force
Missing files	File not tracked	Check file exists in correct directory
Schema error	Invalid YAML	Validate with systemprompt admin config validate

Quick Reference

Task	Command
Push	systemprompt cloud sync push
Pull	systemprompt cloud sync pull
Preview push	systemprompt cloud sync push --dry-run
Force push	systemprompt cloud sync push --force
Sync admin user	systemprompt cloud sync admin-user