# baken667/envee architecture

> Architecture diagram of the GitHub repository baken667/envee, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/baken667/envee
- Repository: https://github.com/baken667/envee

## Overview

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: [`src/resolver.zig`](https://github.com/baken667/envee/blob/main/src/resolver.zig) (Environment resolver), [`src/cli/root.zig`](https://github.com/baken667/envee/blob/main/src/cli/root.zig) (Command router), [`src/cli/trust.zig`](https://github.com/baken667/envee/blob/main/src/cli/trust.zig) (Trust review), [`src/shell/hooks`](https://github.com/baken667/envee/tree/main/src/shell/hooks) (Shell hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Shell and CLI"]
  node_shell["Shell hook"]
  node_cli["Command router<br/>[root.zig]"]
  node_shell_emit["Shell updates<br/>[shell.zig]"]
  node_import["direnv import<br/>[import.zig]"]
end

subgraph group_config["Configuration and trust"]
  node_config_file["envee.toml"]
  node_config_parse["Config parsing<br/>[config.zig]"]
  node_static_check["Static check<br/>[check.zig]"]
  node_trust_review["Trust review<br/>[trust.zig]"]
  node_trust_store[("Trust store<br/>[store.zig]")]
  node_trust_sign["Signed approvals<br/>[sign.zig]"]
end

subgraph group_resolve["Resolution and secrets"]
  node_resolver["Environment resolver<br/>[resolver.zig]"]
  node_dotenv["Dotenv input<br/>[dotenv.zig]"]
  node_secrets["Secret commands<br/>[secret.zig]"]
  node_secret_store[("Local secret store<br/>[secret_store.zig]")]
  node_plugin_protocol["Plugin protocol<br/>[protocol.zig]"]
  node_plugin_process["Plugin executables"]
end

subgraph group_sdk["Plugin author SDK"]
  node_plugin_env["Go plugin SDK<br/>[protocol.go]"]
end

node_user(("Project user"))

node_user -->|"changes directory"| node_shell
node_shell -->|"invokes eval"| node_cli
node_cli -->|"loads config"| node_config_file
node_config_file -->|"parsed as TOML"| node_config_parse
node_cli -->|"resolves environment"| node_resolver
node_resolver -->|"returns updates"| node_shell_emit
node_shell_emit -->|"applies exports"| node_shell
node_user -->|"approves config"| node_trust_review
node_trust_review -->|"records approval"| node_trust_store
node_trust_review -->|"signs approval"| node_trust_sign
node_user -->|"checks config"| node_static_check
node_resolver -->|"loads dotenv"| node_dotenv
node_user -->|"manages secrets"| node_secrets
node_secrets -->|"reads and writes"| node_secret_store
node_resolver -->|"resolves plugin refs"| node_plugin_protocol
node_plugin_protocol -->|"dispatches requests"| node_plugin_process
node_plugin_env -->|"implements protocol"| node_plugin_protocol
node_user -->|"converts envrc"| node_import
node_import -->|"writes TOML"| node_config_file

click node_shell "https://github.com/baken667/envee/tree/main/src/shell/hooks"
click node_cli "https://github.com/baken667/envee/blob/main/src/cli/root.zig"
click node_shell_emit "https://github.com/baken667/envee/blob/main/src/shell/shell.zig"
click node_config_parse "https://github.com/baken667/envee/blob/main/src/config.zig"
click node_static_check "https://github.com/baken667/envee/blob/main/src/cli/check.zig"
click node_trust_review "https://github.com/baken667/envee/blob/main/src/cli/trust.zig"
click node_trust_store "https://github.com/baken667/envee/blob/main/src/trust/store.zig"
click node_trust_sign "https://github.com/baken667/envee/blob/main/src/trust/sign.zig"
click node_resolver "https://github.com/baken667/envee/blob/main/src/resolver.zig"
click node_dotenv "https://github.com/baken667/envee/blob/main/src/dotenv.zig"
click node_secrets "https://github.com/baken667/envee/blob/main/src/cli/secret.zig"
click node_secret_store "https://github.com/baken667/envee/blob/main/src/secret_store.zig"
click node_plugin_protocol "https://github.com/baken667/envee/blob/main/src/plugins/protocol.zig"
click node_plugin_process "https://github.com/baken667/envee/tree/main/src/plugins"
click node_plugin_env "https://github.com/baken667/envee/blob/main/pkg/sdk-go/protocol.go"
click node_import "https://github.com/baken667/envee/blob/main/src/cli/import.zig"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell,node_cli,node_shell_emit,node_import,node_user toneBlue
class node_config_file,node_config_parse,node_static_check,node_trust_review,node_trust_store,node_trust_sign toneAmber
class node_resolver,node_dotenv,node_secrets,node_secret_store,node_plugin_protocol,node_plugin_process toneMint
class node_plugin_env toneRose
```

## Components

### Shell and CLI

- [Shell hook](https://github.com/baken667/envee/tree/main/src/shell/hooks): `src/shell/hooks`
- [Command router](https://github.com/baken667/envee/blob/main/src/cli/root.zig): `src/cli/root.zig`
- [Shell updates](https://github.com/baken667/envee/blob/main/src/shell/shell.zig): `src/shell/shell.zig`
- [direnv import](https://github.com/baken667/envee/blob/main/src/cli/import.zig): `src/cli/import.zig`

### Configuration and trust

- **envee.toml**
- [Config parsing](https://github.com/baken667/envee/blob/main/src/config.zig): `src/config.zig`
- [Static check](https://github.com/baken667/envee/blob/main/src/cli/check.zig): `src/cli/check.zig`
- [Trust review](https://github.com/baken667/envee/blob/main/src/cli/trust.zig): `src/cli/trust.zig`
- [Trust store](https://github.com/baken667/envee/blob/main/src/trust/store.zig): `src/trust/store.zig`
- [Signed approvals](https://github.com/baken667/envee/blob/main/src/trust/sign.zig): `src/trust/sign.zig`

### Resolution and secrets

- [Environment resolver](https://github.com/baken667/envee/blob/main/src/resolver.zig): `src/resolver.zig`
- [Dotenv input](https://github.com/baken667/envee/blob/main/src/dotenv.zig): `src/dotenv.zig`
- [Secret commands](https://github.com/baken667/envee/blob/main/src/cli/secret.zig): `src/cli/secret.zig`
- [Local secret store](https://github.com/baken667/envee/blob/main/src/secret_store.zig): `src/secret_store.zig`
- [Plugin protocol](https://github.com/baken667/envee/blob/main/src/plugins/protocol.zig): `src/plugins/protocol.zig`
- [Plugin executables](https://github.com/baken667/envee/tree/main/src/plugins): `src/plugins`

### Plugin author SDK

- [Go plugin SDK](https://github.com/baken667/envee/blob/main/pkg/sdk-go/protocol.go): `pkg/sdk-go/protocol.go`

### Other components

- **Project user**

## Connections

- Project user → Shell hook: changes directory (evidence: `README.md`)
- Shell hook → Command router: invokes eval (evidence: `README.md`)
- Command router → envee.toml: loads config (evidence: `README.md`)
- envee.toml → Config parsing: parsed as TOML (evidence: `README.md`)
- Command router → Environment resolver: resolves environment (evidence: `README.md`)
- Environment resolver → Shell updates: returns updates (evidence: `README.md`)
- Shell updates → Shell hook: applies exports (evidence: `README.md`)
- Project user → Trust review: approves config (evidence: `README.md`)
- Trust review → Trust store: records approval (evidence: `README.md`)
- Trust review → Signed approvals: signs approval (evidence: `README.md`)
- Project user → Static check: checks config (evidence: `README.md`)
- Environment resolver → Dotenv input: loads dotenv (evidence: `README.md`)
- Project user → Secret commands: manages secrets (evidence: `README.md`)
- Secret commands → Local secret store: reads and writes (evidence: `README.md`)
- Environment resolver → Plugin protocol: resolves plugin refs (evidence: `README.md`)
- Plugin protocol → Plugin executables: dispatches requests (evidence: `README.md`)
- Go plugin SDK → Plugin protocol: implements protocol (evidence: `pkg/sdk-go/protocol.go`)
- Project user → direnv import: converts envrc (evidence: `README.md`)
- direnv import → envee.toml: writes TOML (evidence: `README.md`)
