CommandPost is made up of two seperate components:
- CommandPost-App contains the Hammerspoon fork which makes up the main application.
- CommandPost contains all the Lua scripts that drive the interface and feature set.
The goal of CommandPost-App is to always stay compatible with Hammerspoon, to allow us to always be able to bring across bug fixes and new features from the Hammerspoon repository to the ComamndPost-App fork.
We also don't touch the Hammerspoon/setup.lua or extensions/_coresetup/init.lua files within the CommandPost-App repository - this is all done in the CommandPost fork.
In most cases, you should never really need to make changes to CommandPost-App, as all the user interfaces and features are built with Lua scripts.
However, if there is something missing from CommandPost-App that you want to add to the application (for example we added the "Drag & Drop to Dock" callbacks), ideally you would commit this to the main Hammerspoon repository first (so that the Hammerspoon community can also benefit from it), and then update CommandPost-App from Hammerspoon/master.
For more information on contributing to Hammerspoon, refer to their Contribution Guide.
There's also a fantastic Hammerspoon Module Walkthrough here, which includes examples of how to make Objective-C extensions.
If you have any questions about this, feel free to submit an issue.