devenv-info(1)

📦
version 2.4.0 · 2 versions
, in nixpkgs unstable

💅 devenv-info(1) — the General Commands Manual energy, but make it group chat

okay so bestie, welcome to devenv-info, straight out of the General Commands Manual section. this is the little page that tells you what devenv info does. it's short. it's sweet. it's giving utility player. let's get into it 🫶

✨ NAME ✨

devenv-info — print information about this developer environment. that's it. that's the whole job. and it does it beautifully 💖

🌸 SYNOPSIS 🌸

devenv info [--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]

yeah. that's a lot of flags. we love a maximalist queen 👑

🦋 DESCRIPTION 🦋

Print information about this developer environment. literally the entire plot. no twists, no subplot, just vibes and info ✨

🎀 OPTIONS 🎀

  • --user-config <USER_CONFIG> — use this user configuration file instead of the XDG default. main character config file energy, honestly.

🌈 INPUT OVERRIDES 🌈

this is the section where you get to be a little bit of a control freak about where your stuff comes from. respectfully. 💅

  • --from <FROM> — source for devenv.nix. it can be either a filesystem path (with the path: prefix, don't forget it bestie) or a flake input reference.

examples, slay:

--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. lowkey the most useful thing ever.

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. yes, you must include a type. the syntax is <attribute>:<type>.

supported types, memorise these: string, int, float, bool, path, pkg, pkgs

list types (pkgs) append to existing values by default. add a ! suffix to replace instead: pkgs! — that exclamation mark is doing SO much work, iconic honestly 🔥

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 ⭐

nix era. buckle up 🎀

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

defaults to 1/4 of available CPU cores (minimum 1). very "we split the work, we don't all pile on" of it.

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

defaults to available cores divided by max-jobs (minimum 1). the math is mathing, trust 💖

  • -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. you're letting a little chaos in. respectfully.
  • --no-impure — force a hermetic environment, overriding config. the responsible older sibling flag.
  • --offline — disable substituters and consider all previously downloaded files up-to-date. airplane mode but make it nix 🛫
  • --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. this is for the girls who like to look the problem directly in the eye 👀

🐚 SHELL OPTIONS 🐚

  • -c, --clean [<CLEAN>...] — ignore existing environment variables when entering the shell. pass a list of comma-separated environment variables to let through. fresh start energy ✨
  • -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). it just knows 🦋
  • --no-reload — disable auto-reload when config files change. for when you need a moment of peace.
  • --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). speed, slay, etc 💅
  • --no-eval-cache — disable caching of Nix evaluation results.
  • --refresh-eval-cache — force a refresh of the Nix evaluation cache. out with the old, in with the fresh.
  • --refresh-task-cache — force a refresh of the task cache. same energy, different cache.

🔐 SECRETSPEC OPTIONS 🔐

  • --secretspec-provider <SECRETSPEC_PROVIDER> — override the secretspec provider. very mysterious. very demure.
  • --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. yes bestie you can have several.

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) — and [env: DEVENV_TRACE_DEFAULT_TO=] (comma-separated, used only when no explicit tracing is configured; set to empty string to suppress). big environment variable energy, no cap 🧚

💜 GLOBAL OPTIONS 💜

  • -v, --verbose — enable additional debug logs. for the girlies who need to see everything.
  • -q, --quiet — silence all logs. peace and quiet, we respect it deeply 🫶
  • --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 little shortcut that loves you back 😭

🌸 the sign-off 🌸

and that's the page, bestie! this one's from the info corner of the world — it's devenv-info(1), filed proudly under General Commands Manual, and it's the whole manual. go print some info. you're gonna ate 💖✨🎀

ily, go touch a devenv 🦋

📦 where this page comes from