https://github.com/juspay/omnix

A Nix companion to improve developer experience
https://github.com/juspay/omnix

developer-experience nix nix-flakes nixos

Last synced: 10 months ago
JSON representation

A Nix companion to improve developer experience

• Host: GitHub
• URL: https://github.com/juspay/omnix
• Owner: juspay
• License: agpl-3.0
• Created: 2023-05-27T01:08:11.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-04T20:54:33.000Z (11 months ago)
• Last Synced: 2025-04-06T07:11:18.357Z (11 months ago)
• Topics: developer-experience, nix, nix-flakes, nixos
• Language: Rust
• Homepage: https://omnix.page
• Size: 1.67 MB
• Stars: 162
• Watchers: 14
• Forks: 16
• Open Issues: 31
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• best-of-nix - GitHub - 20% open · ⏱️ 05.09.2025) (Development)

README

          
[![project chat](https://img.shields.io/github/discussions/juspay/omnix)](https://github.com/juspay/omnix/discussions)

[![Naiveté Compass of Mood](https://img.shields.io/badge/naïve-FF10F0)](https://compass.naivete.me/ "This project follows the 'Naiveté Compass of Mood'")

# omnix



*Pronounced [`/ɒmˈnɪks/`](https://ipa-reader.com/?text=%C9%92m%CB%88n%C9%AAks&voice=Geraint)*

Omnix aims to supplement the [Nix](https://nixos.asia/en/nix) CLI to improve developer experience.

## Usage

See 

## Developing

1. [Install Nix](https://nixos.asia/en/install)

1. [Setup `direnv`](https://nixos.asia/en/direnv)

1. Clone this repo, `cd` to it, and run `direnv allow`.

This will automatically activate the nix develop shell. Open VSCode and install recommended extensions, ensuring that direnv activates in VSCode as well.

### Running locally

To run `omnix-cli`,

```sh

just watch # Or `just w`; you can also pass args, e.g.: `just w show`

```

### Nix workflows

Inside the nix develop shell (activated by direnv) you can use any of the `cargo` or `rustc` commands, as well as [`just`](https://just.systems/) workflows. Nix specific commands can also be used to work with the project:

```sh

# Full nix build of CLI

nix build

# Build and run the CLI

nix run

```

### Contributing

>[!TIP]

> Run `just pca` 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 run `just doc check`

    - To preview Rust API docs, run `just doc cargo`.

- Changes must accompany a corresponding `history.md` entry.[^cc]

[^cc]: We don't use any automatic changelog generator for this repo.