Skip to main content

​
Usage

Reads your local AI tool config, shows a diff preview, and uploads it to the cloud after confirmation.

​
Options

​
Examples

Push Claude Code config (default):
Push Cursor config:
Push to a team:
Push a Claude profile:
Push with a version message:
Force push (overwrite cloud with local):

​
Behavior

​
Smart merge (default)

When a config already exists in the cloud, lazy push performs a smart merge:
  • Local wins on conflicts — your local changes take priority
  • Cloud-only fields are preserved — things that exist in the cloud but not locally stay untouched
  • A diff preview is shown before applying

​
Force mode

With --force, the cloud config becomes an exact copy of your local files. No merge, no preserved fields.

​
Version messages

Each push includes a change summary that describes what changed. You can also add a custom message with -m:
If no message is provided, an auto-generated summary is created from the diff (e.g. “Modified CLAUDE.md, added .mcp.json”).

​
No changes

If your local config is identical to the cloud version (same hash), the push is skipped and no new version is created.

​
Limits

  • Maximum payload size: 512 KB per config
  • Config name: alphanumeric, dashes, and underscores only (max 100 characters)
  • Valid tools: claude, cursor, copilot, gemini, windsurf, cline
New configs count against your plan’s config limit. See Plans for details.