From a0cf62375db1a3b6e99414047ded54850d9c449d Mon Sep 17 00:00:00 2001
From: jope-bm <joe@basicmemory.com>
Date: Thu, 10 Jul 2025 10:18:43 -0600
Subject: [PATCH] docs: improve virtual environment setup instructions (#222)

Co-authored-by: Claude <noreply@anthropic.com>
---
 CONTRIBUTING.md | 7 ++++++-
 justfile        | 3 +++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 80bd5eeb..6a613f7b 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -27,7 +27,12 @@ project and how to get started as a developer.
 
    > **Note**: Basic Memory uses [just](https://just.systems) as a modern command runner. Install with `brew install just` or `cargo install just`.
 
-3. **Run the Tests**:
+3. **Activate the Virtual Environment**
+   ```bash
+   source .venv/bin/activate
+   ```
+
+4. **Run the Tests**:
    ```bash
    # Run all tests
    just test
diff --git a/justfile b/justfile
index 7bf4f00a..c505e8fc 100644
--- a/justfile
+++ b/justfile
@@ -3,6 +3,9 @@
 # Install dependencies
 install:
     pip install -e ".[dev]"
+    uv sync
+    @echo ""
+    @echo "💡 Remember to activate the virtual environment by running: source .venv/bin/activate"
 
 # Run unit tests in parallel
 test-unit: