Synchronizes packages installed between computers by installing the packages listed in a configuration file.
Package Sync reads
~/.atom/packages.cson, compares what is in there to the list of available packages and installs any packages that it finds are missing.
Creating the Package List
You can create the initial package list from the packages you have installed by using the
Create Package List command. It will include all packages you currently have installed in the
~/.atom/packages directory. The package list can be edited from there if you wish to add or remove any packages from the list.
Create Package List will not overwrite a pre-existing package list. If you want to start over, you have to manually delete
~/atom/packages.cson and then call
Create Package List to create it anew.
Editing the Package List
You can edit the package list at any time by opening it with the
Open Package List command. It will open the
~/.atom/packages.cson file in a new Atom tab.
Synchronizing your Packages
Once you have the package list set the way you want, any time you wish to ensure that you have all of your required packages, you can execute the
packages.cson file follows the format:
Where the contents of the array is a list of packages to ensure are installed.
createOnChange— Create the package list when packages are installed or removed via the Atom settings. You must restart Atom after installing Package Sync for this setting to take effect, and it works best when paired with the
forceOverwrite— Forces the
create-package-listcommand to overwrite the
packages.csonif it exists.
package-sync:create-package-list— Creates the
~/.atom/packages.csonfile if it does not already exist
package-sync:open-package-list— Opens the
~/.atom/packages.csonin a new tab
package-sync:sync— Syncs between the package list and the installed packages
No keybindings are configured by default for the commands in this package.
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.