syntaxis/docs/howto/workspace_env_info.md
Jesús Pérez 9cef9b8d57 refactor: consolidate configuration directories
Merge _configs/ into config/ for single configuration directory.
Update all path references.

Changes:
- Move _configs/* to config/
- Update .gitignore for new patterns
- No code references to _configs/ found

Impact: -1 root directory (layout_conventions.md compliance)
2025-12-26 18:36:23 +00:00

1.2 KiB

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!