Installation
Methods
CLI installation method. Run the command in your terminal to fully install Codify. This command works for both arm64 and x64 architectures. Currently only MacOS is supported.
Note: sudo may be needed to complete the installation
MacOS:
Prepackaged installer. Run the installer and follow the instructions to install Codify.
MacOS:
Portable standalone installation. Download the raw tarballs for Codify and unzip. You will be responsible for adding
the executable (/bin/codify.sh
) to your path to run codify from
elsewhere on the system.
Verify installation
If the installation was successful you should see:
Getting started
Let’s create a basic codify.json
and install jq
via homebrew
.
- Create a
codify.json
file in any directory.
- Open the file with your favourite text editor and add the following configs
- Run
codify apply
to generate a plan.
- Codify will now plan out the installations needed to ensure that homebrew and the homebrew formula jq is installed. More information about the homebrew resource here. The plan may vary depending on what’s already been installed on the computer.
- Respond yes to apply the changes. Open a new terminal tab or source your startup script to use the newly installed packages.
Enable codify.json
auto-completion
Enable auto-completion and syntax checking in your favourite editors for codify.json
files.
Autocompletion and validation for codify.json
files work automatically without additional installations.
This applies to all Jetbrains based IDEs such as Intellij IDEA, Webstorm, Phpstorm, Pycharm, CLion, Android Studios, and etc…
*Note that JSON auto-completion on Jetbrains IDEs has several unresolved bugs (see here and here) leading to additional properties sometimes being suggested when they aren’t a part of the config. The validation check should catch these and highlight them as errors.
To enable auto-completion with vscode
:
- For JSON support, install the extension JSON Schema store Catalog
- For YAML support, install the extension YAML
To enable auto-completion with sublime
:
Instructions:
- Open the command palette and run
Package Control: Install Package
, then selectLSP
- Install
LSP-yaml
orLSP-json
from Package Control - Restart Sublime
To enable auto-completion with emacs
:
Install eglot.
To enable auto-completion with neovim
:
Install SchemaStore.nvim
For other editors and custom use cases the JSON schema for Codify and the core plugin and be found here: https://raw.githubusercontent.com/codifyCLI/codify-schemas/main/src/schemastore/codify-schema.json
Load this with a JSON schema compatible editor to enable auto-completion and validation checks. This file is regularly updated with new resources and changes.