{"repo":"ashwch/auto-uv-env","free":true,"listed":false,"github":"https://github.com/ashwch/auto-uv-env","clone":"git clone https://github.com/ashwch/auto-uv-env.git","description":"Automatic UV-based Python virtual environment management for seamless project workflows","language":"Shell","stars":10,"topics":["automation","bash","developer-tools","environment-management","fish","productivity","pyproject","python","python-tooling","shell"],"license":"MIT","category":"cli-tools","readme_excerpt":"auto-uv-env 🐍 Automatic UV-based Python virtual environment management for your shell. auto-uv-env watches directory changes, discovers the nearest pyproject.toml , creates a project-local virtual environment with uv , and activates/deactivates it automatically. Architecture Overview Quick Start 1) Install UV 2) Install auto-uv-env Installer script: Homebrew: 3) Add shell integration Zsh ( /.zshrc ): Bash ( /.bashrc ): Fish ( /.config/fish/config.fish ): 4) Use it Core Behavior 1. Walk upward from $PWD to find the nearest pyproject.toml . 2. If .auto-uv-env-ignore appears first, skip activation for that subtree. 3. Read requires-python from the discovered project root. 4. Create /.venv when missing. 5. Activate on entry and deactivate only environments managed by auto-uv-env. 6. If a manual venv is active, auto-uv-env does not override it. Configuration Environment variables: - AUTO UV ENV QUIET=1 : suppress status messages. - AUTO UV ENV VENV NAME=.venv : change the venv directory name. - AUTO UV ENV PYTHON VERSION : exported Python version of the active managed env. pyproject.toml example: Disable in a subtree: Ignore precedence: - Upward discovery stops activation when ignore is found before pyproject.toml . - Entering an ignored subtree deactivates the currently managed environment. CLI Reference --check-safe emits directive lines (for shell adapters), for example: Why the shell adapters are careful The shell adapters ( bash , zsh , fish ) run inside your live shell sess","default_branch":null,"files":null,"tree":[],"storefront":"/r/ashwch","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/ashwch/auto-uv-env/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}