From 9b19f8f4b1c6b4ec43a10245dd3bef465ed9b5a5 Mon Sep 17 00:00:00 2001
From: Zanie Blue <contact@zanie.dev>
Date: Tue, 3 Jun 2025 12:44:51 -0500
Subject: [PATCH] Add warning about shadowed uv binaries to
 `activate-environment` (#439)

Closes https://github.com/astral-sh/uv/issues/13785
---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index a875426..3d3e913 100644
--- a/README.md
+++ b/README.md
@@ -137,6 +137,16 @@ This allows directly using it in later steps:
 - run: uv pip install pip
 ```
 
+> [!WARNING]
+>
+> Activating the environment adds your dependencies to the `PATH`, which could break some workflows.
+> For example, if you have a dependency which requires uv, e.g., `hatch`, activating the
+> environment will shadow the `uv` binary installed by this action and may result in a different uv
+> version being used.
+>
+> We do not recommend using this setting for most use-cases. Instead, use `uv run` to execute
+> commands in the environment.
+
 ### Working directory
 
 You can set the working directory with the `working-directory` input.