Skip to content

docs(agents): run just through nix develop outside the dev shell - #872

Merged
kixelated merged 1 commit into
mainfrom
docs/pullfrog-nix-develop
Nov 19, 2026
Merged

kixelated merged 1 commit into
mainfrom
docs/pullfrog-nix-develop

Conversation

@kixelated

@kixelated kixelated commented Nov 19, 2026 •

Copy link
Copy Markdown
Collaborator

Pullfrog's dispatched run on main (see moq-dev/quest#779) found just check/just test fail in its job as set up, only because the "Put the dev shell's tools on PATH" step exports the shell's PATH and not its variables (e.g. PKG_CONFIG_PATH, NIX_LDFLAGS); run through nix develop --command, they pass. This tells agents so in AGENTS.md, instead of exporting more variables to the agent.

Docs only; no public API or wire impact.

(Written by Claude Sonnet 5.5 with high effort)

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added guidance for running project commands in environments that do not load the development shell’s environment variables.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

Explain Change →

No actionable comments were generated in the recent review.

Walkthrough

AGENTS.md adds guidance to run just through nix develop --command when the development shell is not active and required environment variables may be unavailable.

Changes: Development environment guidance

Layer / File(s) Summary
Document the just invocation
AGENTS.md
Adds an instruction to run just through nix develop --command outside the development shell, where variables such as PKG_CONFIG_PATH and NIX_LDFLAGS may be unavailable.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Change: Other

Suggested reviewers: pullfrog

Merge Risk: Minimal · up to a779e

This change only adds contributor guidance on running just through the Nix development shell when it is not already active. It does not change runtime behavior and carries no meaningful merge risk.

Architecture risk: Low · up to a779e

The change affects 1 system.

Changed systems: AGENTS.md

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

  • observed — AGENTS.md (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

  • observed — Modified behavior in AGENTS.md: Adds instructions to run just as nix develop --command just ... outside the dev shell, where tools may be on PATH but shell variables such as PKG_CONFIG_PATH and NIX_LDFLAGS are unavailable.
Pre-merge checks: Passed 4

Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check Passed The title names the main change: AGENTS.md now tells agents to run just through nix develop when they work outside the development shell. The changeset adds one line of guidance to AGENTS.md that does…
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.
Full details: Title check

Explanation

The title names the main change: AGENTS.md now tells agents to run just through nix develop when they work outside the development shell. The changeset adds one line of guidance to AGENTS.md that does exactly this, so the title matches the change. The title uses the conventional docs(agents) prefix and stays within one short sentence.

Finishing Touches

Generate unit tests (beta)

  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts
Recent review info

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 67f3196c-70f8-45c6-b21a-720d78249818
Commits

Reviewing files that changed from the base of the PR and between 52070b3 and a779e9e.

Files selected for processing: 1

  • AGENTS.md

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 2 remain after this review.

@pullfrog pullfrog 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.

✅ No new issues found.

Reviewed changes: the single added line in AGENTS.md.

  • nix develop guidance: tells agents outside the dev shell to run just as nix develop --command just ..., since only the shell's PATH is exported and not variables like PKG_CONFIG_PATH or NIX_LDFLAGS.

Pullfrog  | View workflow run | Using claude-sonnet-5-5 | 𝕏

@kixelated
kixelated added this pull request to the merge queue Nov 19, 2026
Merged via the queue into main with commit ab8de7c Nov 19, 2026
6 checks passed
@kixelated
kixelated deleted the docs/pullfrog-nix-develop branch November 19, 2026 11:16
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.

1 participant