ifiokjr/dotfiles/devenv

devenv skill

Activation

Load this skill when devenv.nix exists in the project root, or when the user mentions devenv, Nix shells, or project task runners.

Quick start

# Enter the development shell (sets up PATH, env, git hooks)
devenv test
 
# Run a one-off command inside the shell
devenv shell <command>
 
# Run a named script
devenv shell <script-name>
# Example: devenv shell lint:all

Core rules

1. Prefer devenv scripts over raw commands. When a scripts block exists in devenv.nix,

always use the script name instead of the underlying command.

```bash # Preferred devenv shell lint:all devenv shell test:all

# Avoid cargo clippy --workspace --all-features -- -D warnings pnpm test ```

1. Use devenv shell <command> when direct commands fail. If pnpm, cargo, or other

project tools are not on PATH, prefix with devenv shell:

``bash devenv shell pnpm install devenv shell cargo build --workspace ``

1. Use devenv test to enter the shell for interactive work or to verify the environment

is correctly set up.

1. Check devenv.nix scripts before inventing commands. Always read the scripts block to

find existing task names before running raw commands.

Common patterns

Running project tasks

devenv shell build:all       # Build everything
devenv shell test:all        # Run all tests
devenv shell lint:all        # Run all lints
devenv shell fix:all         # Fix all autofixable problems
devenv shell docs:check      # Check documentation
devenv shell docs:update     # Update shared docs

Managing the environment

devenv test                  # Enter the shell (sets up env + hooks)
devenv update                # Update flake inputs
devenv gc                    # Garbage collect old generations

Running processes

devenv up                    # Start all processes (postgres, redis, etc.)
devenv processes status      # Check running processes

When scripts aren't on PATH

Some devenv configurations set enterShell to add scripts to PATH via:

enterShell = ''
  export PATH="$DEVENV_ROOT/scripts:$PATH"
'';

In those cases, scripts may be available directly inside devenv test. Outside the shell, always use devenv shell <script-name>.

Script naming conventions

The user's preferred devenv.nix layout uses colon-separated namespaced scripts:

• build:* runs build tasks
• test:* runs test tasks
• lint:* runs lint and check tasks
• fix:* runs autofix tasks
• install:* runs dependency installation tasks
• update:* runs update tasks
• docs:* runs documentation tasks
• coverage:* runs coverage tasks
• snapshot:* runs snapshot update and review tasks
• setup:* runs editor and tool setup tasks
• clean:* runs cleanup tasks
• deny:check runs security and license checks
• publish:check runs publication dry-run checks

See also

For the recommended devenv.nix layout, script structure, and git-hooks configuration, see REFERENCE.md.