Skip to content

chore: document required nix option#1609

Open
edipascale wants to merge 1 commit into
mainfrom
ema/document-nix-trick
Open

chore: document required nix option#1609
edipascale wants to merge 1 commit into
mainfrom
ema/document-nix-trick

Conversation

@edipascale

Copy link
Copy Markdown
Contributor

following just the installation notes in the README I was not able to run 'just build' until someone pointed out to me the required option in nix.conf, so let's make sure future developers will not hit the same issue

Copilot AI review requested due to automatic review settings June 29, 2026 16:46
@edipascale edipascale requested a review from a team as a code owner June 29, 2026 16:46
@edipascale edipascale requested review from Fredi-raspall and removed request for a team June 29, 2026 16:46
@coderabbitai

coderabbitai Bot commented Jun 29, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@edipascale, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 56 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 08ed48dc-6d9c-459d-a176-74109f4aa45b

📥 Commits

Reviewing files that changed from the base of the PR and between 74bf034 and c8eddf0.

📒 Files selected for processing (1)
  • README.md
📝 Walkthrough

Walkthrough

Adds a [!NOTE] callout in README.md under the Prerequisites section, instructing users to set experimental-features = nix-command flakes in /etc/nix/nix.conf.

README Prerequisites Update

Layer / File(s) Summary
Nix experimental-features prerequisite note
README.md
Adds a [!NOTE] block under Prerequisites specifying that experimental-features = nix-command flakes must be present in /etc/nix/nix.conf.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the README update documenting a required nix option.
Description check ✅ Passed The description matches the change by explaining the missing nix.conf option needed for just build.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documents a required Nix configuration option so developers following the README don’t hit failures when running just build / other Nix commands.

Changes:

  • Adds a README note to enable nix-command and flakes via experimental-features in nix.conf.

Comment thread README.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
README.md (1)

24-27: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Clarify configuration path alternatives and affected commands.

The note only mentions /etc/nix/nix.conf, which requires root and is system-wide. Since the prerequisites recommend single-user Nix installation, users may not have write access to /etc/nix/nix.conf. Nix also respects per-user configuration at ~/.config/nix/nix.conf (or $XDG_CONFIG_HOME/nix/nix.conf). Consider mentioning this as an alternative path.

Additionally, "some commands will fail" is vague. Since the PR description indicates just build failed without this setting, specify the nix-related commands that require these experimental features (e.g., nix-shell, nix build, nix develop).

> [!NOTE]
-> Make sure to add `experimental-features = nix-command flakes` to `/etc/nix/nix.conf`, or some commands will fail
+> Make sure to add `experimental-features = nix-command flakes` to `/etc/nix/nix.conf` (or `~/.config/nix/nix.conf` for per-user config), or nix commands like `nix-shell` and `just build` will fail
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 24 - 27, Update the note in README.md to mention both
the system-wide Nix config path and the per-user alternative so it matches
single-user installs: reference the existing nix.conf guidance and add
~/.config/nix/nix.conf (or $XDG_CONFIG_HOME/nix/nix.conf) as an option. Also
replace the vague “some commands will fail” wording with the specific Nix
commands affected, using the current note text to point readers toward
nix-shell, nix build, nix develop, and any build flow such as just build that
depends on them.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@README.md`:
- Around line 24-27: Update the note in README.md to mention both the
system-wide Nix config path and the per-user alternative so it matches
single-user installs: reference the existing nix.conf guidance and add
~/.config/nix/nix.conf (or $XDG_CONFIG_HOME/nix/nix.conf) as an option. Also
replace the vague “some commands will fail” wording with the specific Nix
commands affected, using the current note text to point readers toward
nix-shell, nix build, nix develop, and any build flow such as just build that
depends on them.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: b1ce30ac-ba92-4a47-9e76-fa3360c2d746

📥 Commits

Reviewing files that changed from the base of the PR and between 2572239 and 74bf034.

📒 Files selected for processing (1)
  • README.md

following just the installation notes in the README I was
not able to run 'just build' until someone pointed out to
me the required option in nix.conf, so let's make sure
future developers will not hit the same issue

Signed-off-by: Emanuele Di Pascale <emanuele@githedgehog.com>
@edipascale edipascale force-pushed the ema/document-nix-trick branch from 74bf034 to c8eddf0 Compare June 29, 2026 16:50

@Fredi-raspall Fredi-raspall left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks @edipascale !

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants