devenv-user-config-path(1)

📦 version 2.4.0, in nixpkgs unstable

✨ devenv-user-config-path(1) ✨

okay so bestie, this is a page from the General Commands Manual, and it's all about one tiny little command that just… tells you where your user config lives. that's it. that's the whole vibe. but the option list? iconic and long. let's go 💅

🌸 NAME 🌸

devenv-user-config-path — print the resolved user configuration path. literally just prints it. no cap.

🦋 SYNOPSIS 🦋

devenv user-config path [--user-config] [--from] [-o|--override-input]
[-O|--option] [-j|--max-jobs] [-u|--cores] [-s|--system] [-i|--impure]
[--no-impure] [--offline] [--nix-option] [--nix-debugger] [-c|--clean]
[-P|--profile] [--reload] [--no-reload] [--shell] [--eval-cache]
[--no-eval-cache] [--refresh-eval-cache] [--refresh-task-cache]
[--secretspec-provider] [--secretspec-profile] [--trace-to]
[-v|--verbose] [-q|--quiet] [--tui] [--no-tui] [-h|--help]

💖 DESCRIPTION 💖

Print the resolved user configuration path. that's the whole job. it's giving "one-line function that ate and left no crumbs" 🍓

✨ OPTIONS ✨

  • --user-config <USER_CONFIG> — use this user configuration file instead of the XDG default. you're the main character, pick your own file 🎀

🔥 INPUT OVERRIDES 🔥

  • --from <FROM> — the source for devenv.nix.

it can be either a filesystem path (with a path: prefix) or a flake input reference. both are valid, no drama.

Examples:

--from github:cachix/devenv
--from github:cachix/devenv?dir=examples/simple
--from path:/absolute/path/to/project
--from path:./relative/path
  • -o, --override-input <NAME> <URI> — override inputs in devenv.yaml. two args, one glow-up ✨

Examples:

--override-input nixpkgs github:NixOS/nixpkgs/nixos-unstable
--override-input nixpkgs path:/path/to/local/nixpkgs
  • -O, --option <OPTION:TYPE> <VALUE> — override configuration options with typed values. typing matters bestie, don't skip it.

OPTION must include a type: <attribute>:<type>. supported types: string, int, float, bool, path, pkg, pkgs.

List types (pkgs) append to existing values by default. add a ! suffix to replace instead: pkgs! 💀 (yes, the exclamation mark is important)

Examples:

--option languages.rust.channel:string beta
--option services.postgres.enable:bool true
--option languages.python.version:string 3.10
--option packages:pkgs "ncdu git"       (appends to packages)
--option packages:pkgs! "ncdu git"      (replaces all packages)

🧊 NIX OPTIONS 🧊

  • -j, --max-jobs <MAX_JOBS> — maximum number of Nix builds to run concurrently.

defaults to 1/4 of available CPU cores (minimum 1). so like, don't run 300 builds unless you want your laptop to become a space heater 🫠

  • -u, --cores <CORES> — number of CPU cores available to each build.

defaults to available cores divided by max-jobs (minimum 1).

  • -s, --system <SYSTEM> — override the target system.

defaults to the host system (e.g. aarch64-darwin, x86_64-linux).

  • -i, --impure — relax the hermeticity of the environment. chaotic neutral energy 🌈
  • --no-impure — force a hermetic environment, overriding config. back in the bubble you go 🎀
  • --offline — disable substituters and consider all previously downloaded files up-to-date.
  • --nix-option <NAME> <VALUE> — pass additional options to nix commands.

these options are passed directly to Nix using the --option flag. see man nix.conf for the full list of available options.

Examples:

--nix-option sandbox false
--nix-option keep-outputs true
--nix-option system x86_64-darwin
  • --nix-debugger — enter the Nix debugger on failure. when things go wrong, you go in 🔍

🐚 SHELL OPTIONS 🐚

  • -c, --clean [<CLEAN>...] — ignore existing environment variables when entering the shell. pass a list of comma-separated environment variables to let through. spring cleaning, but for env vars 🧹
  • -P, --profile <PROFILES> — activate one or more profiles defined in devenv.nix.

profiles allow you to define different configurations that can be merged with your base configuration.

see https://devenv.sh/profiles for more information.

Examples:

--profile python-3.14
--profile backend --profile fast-startup
  • --reload — enable auto-reload when config files change (default). she's always watching 👀
  • --no-reload — disable auto-reload when config files change.
  • --shell <SHELL_TYPE> — shell to use for interactive sessions (bash, zsh, fish, nu).

possible values:

  • bash
  • zsh
  • fish
  • nu

💾 CACHE OPTIONS 💾

  • --eval-cache — enable caching of Nix evaluation results (default). big brain, less waiting ✨
  • --no-eval-cache — disable caching of Nix evaluation results.
  • --refresh-eval-cache — force a refresh of the Nix evaluation cache.
  • --refresh-task-cache — force a refresh of the task cache.

🔐 SECRETSPEC OPTIONS 🔐

  • --secretspec-provider <SECRETSPEC_PROVIDER> — override the secretspec provider 🤫
  • --secretspec-profile <SECRETSPEC_PROFILE> — override the secretspec profile

🛰️ TRACING OPTIONS 🛰️

  • --trace-to <TRACE_TO> — enable tracing and set output destination(s). can be repeated for multiple outputs. lowkey the most extra option here 💅

Syntax: [format:]destination

Examples:

--trace-to stderr                              # json to stderr
--trace-to pretty:stderr                       # pretty format to stderr
--trace-to json:file:/tmp/trace.json           # JSON to file
--trace-to otlp-grpc                           # OTLP gRPC to default endpoint
--trace-to otlp-grpc:http://collector:4317     # OTLP gRPC to custom endpoint

Multiple outputs:

--trace-to pretty:stderr --trace-to json:file:/tmp/t.json

Destinations: stdout, stderr, file:<path>, http(s)://<host>:<port>. Formats: json (default), pretty, full, otlp-grpc, otlp-http-protobuf, otlp-http-json.

When format is omitted, defaults to json. Tracing is disabled by default.

[env: DEVENV_TRACE_TO=] (comma-separated) [env: DEVENV_TRACE_DEFAULT_TO=] (comma-separated, used only when no explicit tracing is configured; set to empty string to suppress)

👑 GLOBAL OPTIONS 👑

  • -v, --verbose — enable additional debug logs. she's telling you everything 🗣️
  • -q, --quiet — silence all logs. not a single word. 🤐
  • --tui <TUI> — enable the interactive terminal interface (default when interactive).

possible values:

  • true
  • false
  • --no-tui — disable the interactive terminal interface.
  • -h, --help — print help (see a summary with '-h'). the classic.
fr fr: this page is literally just "print the resolved user config path" wearing 40 options as accessories. read the flags carefully, bestie — every one of them is doing something. 💜

and that's the whole page, no notes 🫶 this cutie comes from source path, sitting pretty under devenv-user-config-path(1) — go off, you absolute icon ⭐🎀💖

📦 where this page comes from