How cachix/devenv works
devenv is a Rust CLI for defining and activating reproducible developer environments with Nix. The principal workflow starts with a project configuration, evaluates it into an environment, then activates that environment in a shell. The README also documents process and task management, live terminal UI, reloads, language-server support, containers, and integrations. Paths identify implementations where supported by the tree; some capability links are dashed because the relevant implementation was not sampled, so those connections are not verified.
Main entry points: main.rs CLI · manager.rs Process manager · config.rs Environment config · events.rs Activity events
Components 20
CLI and configuration
- CLI
devenv/src/main.rs - Commands
devenv/src/commands/mod.rs - Environment config
devenv-core/src/config.rs
Evaluation and Nix
- Evaluator
devenv-core/src/evaluator.rs - Nix backend
devenv-nix-backend/src/backend.rs - Eval cache
devenv-eval-cache/src
Environment runtime
- Shell session
devenv-shell/src/session.rs - Process manager
devenv-processes/src/manager.rs - Task runner
devenv-tasks/src/tasks.rs - Readiness probes
devenv-event-sources/src
Developer experience
- Activity events
devenv-activity/src/events.rs - Terminal UI
devenv-tui/src/app.rs - Shell reload
devenv-reload/src - Language server
devenv/src/lsp.rs
Packaging and integrations
- OCI containers
devenv/src/devenv/container.rs - MCP server
devenv/src/mcp.rs - Development proxy
devenv-proxy/src/routes.rs - Secrets integration
devenv-core/src/settings.rs
Other components
- Developer
- Nix tooling
Connections 20
- Developer → CLI: runs
- CLI → Commands: dispatches
devenv/src/main.rs - Developer → Environment config: defines
- CLI → Environment config: loads
- Evaluator → Nix backend: evaluates with
- Evaluator → Eval cache: caches evaluation
- Nix backend → Nix tooling: uses
- CLI → Shell session: activates
- CLI → Process manager: starts processes
- CLI → Task runner: runs tasks
- Process manager → Readiness probes: checks readiness
- Process manager → Activity events: reports events
- Task runner → Activity events: reports events
- Activity events → Terminal UI: drives display
- Shell session → Shell reload: supports reload
- CLI → Language server: starts
- CLI → OCI containers: builds or runs
- CLI → MCP server: launches
- Environment config → Secrets integration: configures
- Process manager → Development proxy: routes services