> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boardrepo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Push and Pull

> Save a project version from KiCad, bring the current version back, and recover an interrupted Pull.

## Push saved edits

Save changes in each open KiCad editor before clicking **BoardRepo: Push or Pull**. The plugin reads the project's saved files on disk. On first use, choose the existing BoardRepo project or create one. For an existing board, your account needs permission to download its source and publish a new version. Check the destination and files, enter an optional version message, then confirm Push. Open the board’s version history, verify the new version, and [share that revision for review](https://docs.boardrepo.com/index.md).

If Push reports an open change request, keep your local files and open the linked request. An authorized collaborator must close or merge it before a direct Push can succeed. If the merge advanced the board, reconcile the new revision with your local work before starting another Push.

## Pull the current version

Save your open editors. To keep independent local edits, copy the saved project outside the synchronized folder before starting. Pull replaces the synchronized files in your local project with the current BoardRepo version. For an older revision, download its source from the board's version history instead.

1. Open the toolbar action, check the board and version, and confirm Pull.
2. Follow the plugin's reload or close instructions for every affected editor. When prompted, use **File → Revert** to load the pulled files from disk. When first connecting to an existing board, you may need to close the project in both editors.
3. Check that the pulled design is visible before confirming. An editor can still show the previous design after the files on disk have changed.

## Recover an interrupted Pull

Open **BoardRepo: Push or Pull** again to resume recovery. Keep the recovery folders in place. If you choose **Undo Pull**, close the affected editors when prompted. Undo restores the previously saved files. Edits that existed only in editor memory cannot be recovered this way.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.