Pronounced /ɒmˈnɪks/
Note
🚧 omnix is in active development. It aims to supplement the Nix CLI to improve developer experience.
- Install Nix
- Setup
direnv
- Clone this repo,
cd
to it, and rundirenv allow
.
This will automatically activate the nix develop shell. Open VSCode and install recommended extensions, ensuring that direnv activates in VSCode as well.
To run omnix-cli
,
just watch # Or `just w`; you can also pass args, e.g.: `just w show`
Inside the nix develop shell (activated by direnv) you can use any of the cargo
or rustc
commands, as well as just
workflows. Nix specific commands can also be used to work with the project:
# Full nix build of CLI
nix build .#default
# Build and run the CLI
nix run
Tip
Run just fmt
to autoformat the source tree.
- Run
just ci
to run CI locally. - Add documentation wherever useful.
- Run
just doc run
to preview website docs; edit, and runjust doc check
- To preview Rust API docs, run
just doc cargo
.
- Run
- Changes to library crates must accompany a corresponding
CHANGELOG.md
entry.1
Footnotes
-
We don't use any automatic changelog generator for this repo. ↩