Files

* Exported Fish Environment: {{ENV_NAME}}
This directory contains a self-contained fish environment.

** Files Structure
   @code
   .fish/
   |-- activate.fish
   |-- readme.norg
   |-- bin/
   @end

** Usage

*** Automatic Activation (Recommended)
    The environment will automatically activate when you `cd` into this directory
    if your Fish shell is configured with the auto-activation script.

    @code fish
    function check_and_source_activate
      if test -f (pwd)/.fish/activate.fish
        source (pwd)/.fish/activate.fish
      elif test -f (pwd)/activate.fish
        source (pwd)/activate.fish
      end
    end

    function cd
      builtin cd $argv && check_and_source_activate
    end
    @end

*** Manual Activation
    To manually activate the environment, run from the project root:
    @code bash
    source ./.fish/activate.fish
    @end

*** Deactivation
    To deactivate the environment, run:
    @code bash
    env deactivate
    @end

    Or simply `cd` to a different directory if using auto-activation.

** What This Environment Provides
   - Prompt showing the environment name
   - Environment-specific aliases and functions
   - Custom environment variables
   - Automatic cleanup when deactivated

** Requirements
   - Fish shell
   - `bass` plugin (`fisher install edc/bass`) for compatibility with bash scripts

** Sharing
   This environment is completely self-contained. You can:
   - Copy this directory to another machine
   - Share it with others
   - Version control it with your project (add .fish/ to your repo)