PMS Manager
The PMS Manager is what you will use most of the time when you want to interact with the PMS framework. This allows you to do things such as enable/disable plugins and switch to different themes.
You can run pms help
at any time to get information on all the commands the
PMS Manager supports.
Managing Plugins
Plugins modify shell behaviour such as loading auto-completion scripts, adding
aliases, or modifying shell options. Plugins are managed using the pms plugin
command.
Listing Current Plugins
pms plugin list
Enabling Plugins
pms plugin enable [PLUGIN]
Disabling Plugins
pms plugin disable [PLUGIN]
Managing Themes
Themes will modify how you shell looks. These are things such as colors and usually includes a kick ass command prompt.
Note Some themes may enable or disable PMS plugins for functionality. An example of this would be a theme that would require the “git-prompt” plugin so it has access to that functionality. This is done for you so you don’t need to do this by hand
Listing Themes
This will show you all the available themes you are able to switch to.
pms theme list
Switching Themes
pms theme switch [THEME]
Managing your Dotfiles
Dotfiles are a very important part of being a developer and most like to make sure those files are backed up. The PMS Manager supports managing your dotfiles using git.
The repository that will be managed will look something like this
Requirements
- git repository
Initializing dotfile management
To get started, just run pms dotfiles init
and follow the instructions
Initializing by hand
To start fresh with a new git repo, follow these steps:
git init --bare $HOME/.dotfiles
git --git-dir=$HOME/.dotfiles --work-tree=$HOME -C $HOME config --local status.showUntrackedFiles no
git --git-dir=$HOME/.dotfiles --work-tree=$HOME -C $HOME remote add origin REPO_URL
NOTE: You will need to make sure you have a git repository already created that would allow you to push to.
If you already have an existing dotfiles repository, follow these steps:
git clone --bare REPO_URL $HOME/.dotfiles
git --git-dir=$HOME/.dotfiles --work-tree=$HOME -C $HOME checkout
git --git-dir=$HOME/.dotfiles --work-tree=$HOME -C $HOME config --local status.showUntrackedFiles no
NOTE: You may run into issues when you run “git checkout”. You will need to resolve those before you con make sure that everything is setup correctly.
Adding files
Adding files is quick, just run pms dotfiles add FILE
and PMS will add the
file to your dotfiles repository, make a commit, and push up your changes.
Pulling down changes
Run pms dotfiles pull
if you have made any changes in your repository that you
want to pull down to your machine.