Summary:

  ✅ Do NOT add to .env (they're handled by wrapper scripts)

  - WORKSPACE_CONFIG_DIR - Set by wrapper to ~/.config/syntaxis
  - WORKSPACE_DATA_DIR - Set by wrapper to ~/.local/share/syntaxis

  ✅ Why This Design is Good:

  1. User-agnostic - Each user gets their own ~/.config/ and ~/.local/share/ directories
  2. Standard Unix - Follows XDG Base Directory specification
  3. Automatic - Wrapper scripts handle it, no manual setup needed
  4. Overridable - Users can still export WORKSPACE_CONFIG_DIR=/custom/path if needed

  ✅ Current System Flow:

  Development:
    cargo run -p syntaxis-cli  (env vars NOT set, uses hardcoded search paths)
    ↓
    find_config_path_warn_conflicts("config.toml")
    ↓
    Searches: .project/ → .vapora/ → .coder/

  Production (after install):
    workspace --help  (wrapper runs first)
    ↓
    Wrapper sets env vars
    ↓
    workspace.real binary runs with environment set

  ✅ Config Discovery (Already Implemented):

  The Rust code in shared/rust/config_finder.rs already handles all the logic. The wrapper is just a convenience layer for
  production use.

  You don't need to add these to .env - the current system is already well-designed! ✅