/sync

Description

> Synchronize issues with git remote in a single operation.

AI Summary

Executes a complete git-based sync workflow: export changes, commit, pull with conflict resolution, import updates, and push. Use this for manual multi-device synchronization when not using the automatic daemon.

Install

Add the repository(one-time)

/plugin marketplace add shaneholloman/beads

Install the plugin

/plugin install beads@beads-marketplace

Command Content

Sync Issues

Synchronize issues with git remote in a single operation.

Sync Steps

Export pending changes to JSONL
Commit changes to git
Pull from remote (with conflict resolution)
Import updated JSONL
Push local commits to remote

Wraps the entire git-based sync workflow for multi-device use.

Usage

Basic sync: beads sync
Preview: beads sync --dry-run
Custom message: beads sync --message "Closed sprint issues"
Pull only: beads sync --no-push
Push only: beads sync --no-pull

Note

Most users should rely on the daemon's automatic sync (beads daemon --auto-commit --auto-push) instead of running manual sync. This command is useful for one-off syncs or when not using the daemon.