How baken667/envee works
envee is a per-directory environment manager: shell hooks invoke its CLI, which resolves a trusted TOML configuration and returns environment updates for the shell. The documented product also includes trust review/signing, static checks, profiles, secret management and import. The tree identifies their implementation paths, but sampled source covers only the Go plugin SDK; links among Zig subsystems below are therefore limited to relationships stated in the README, not inferred from module names.
Main entry points: resolver.zig Environment resolver · root.zig Command router · trust.zig Trust review · hooks Shell hook
Components 18
Shell and CLI
- Shell hook
src/shell/hooks - Command router
src/cli/root.zig - Shell updates
src/shell/shell.zig - direnv import
src/cli/import.zig
Configuration and trust
- envee.toml
- Config parsing
src/config.zig - Static check
src/cli/check.zig - Trust review
src/cli/trust.zig - Trust store
src/trust/store.zig - Signed approvals
src/trust/sign.zig
Resolution and secrets
- Environment resolver
src/resolver.zig - Dotenv input
src/dotenv.zig - Secret commands
src/cli/secret.zig - Local secret store
src/secret_store.zig - Plugin protocol
src/plugins/protocol.zig - Plugin executables
src/plugins
Plugin author SDK
- Go plugin SDK
pkg/sdk-go/protocol.go
Other components
- Project user
Connections 19
- Project user → Shell hook: changes directory
README.md - Shell hook → Command router: invokes eval
README.md - Command router → envee.toml: loads config
README.md - envee.toml → Config parsing: parsed as TOML
README.md - Command router → Environment resolver: resolves environment
README.md - Environment resolver → Shell updates: returns updates
README.md - Shell updates → Shell hook: applies exports
README.md - Project user → Trust review: approves config
README.md - Trust review → Trust store: records approval
README.md - Trust review → Signed approvals: signs approval
README.md - Project user → Static check: checks config
README.md - Environment resolver → Dotenv input: loads dotenv
README.md - Project user → Secret commands: manages secrets
README.md - Secret commands → Local secret store: reads and writes
README.md - Environment resolver → Plugin protocol: resolves plugin refs
README.md - Plugin protocol → Plugin executables: dispatches requests
README.md - Go plugin SDK → Plugin protocol: implements protocol
pkg/sdk-go/protocol.go - Project user → direnv import: converts envrc
README.md - direnv import → envee.toml: writes TOML
README.md