syntaxis/docs/howto/workspace_env_info.md

37 lines
1.2 KiB
Markdown
Raw Permalink Normal View History

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! ✅