vcs-python · tony · Dec 27, 2025 · Dec 27, 2025 · Dec 27, 2025 · Dec 27, 2025
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -53,6 +53,10 @@ jobs:
         if: env.PUBLISH == 'true'
         run: uv sync --all-extras --dev
 
+      - name: Install just
+        if: env.PUBLISH == 'true'
+        uses: extractions/setup-just@v2
+
       - name: Print python versions
         if: env.PUBLISH == 'true'
         run: |
@@ -62,7 +66,7 @@ jobs:
       - name: Build documentation
         if: env.PUBLISH == 'true'
         run: |
-          pushd docs; make SPHINXBUILD='uv run sphinx-build' html; popd
+          cd docs && just html
 
       - name: Configure AWS Credentials
         if: env.PUBLISH == 'true'

diff --git a/AGENTS.md b/AGENTS.md
@@ -42,7 +42,7 @@ uv run pytest tests/test_cli.py::test_sync
 # Watch mode for tests (auto re-run on file changes)
 uv run ptw .
 # or
-make start
+just start
 
 # Run tests with coverage
 uv run py.test --cov -v
@@ -54,31 +54,31 @@ uv run py.test --cov -v
 # Format code with ruff
 uv run ruff format .
 # or
-make ruff_format
+just ruff-format
 
 # Run ruff linting with auto-fixes
 uv run ruff check . --fix --show-fixes
 # or
-make ruff
+just ruff
 
 # Run mypy type checking
 uv run mypy
 # or
-make mypy
+just mypy
 
 # Watch mode for linting (using entr)
-make watch_ruff
-make watch_mypy
+just watch-ruff
+just watch-mypy
 ```
 
 #### Documentation
 
 ```bash
 # Build documentation
-make build_docs
+just build-docs
 
 # Start documentation server (auto-reload)
-make start_docs
+just start-docs
 ```
 
 ## Development Process

diff --git a/CHANGES b/CHANGES
@@ -31,6 +31,13 @@ $ uvx --from 'vcspull' --prerelease allow vcspull
 
 <!-- Maintainers, insert changes / features for the next release here -->
 
+### Development
+
+#### Makefile -> Justfile (#493)
+
+- Migrate from `Makefile` to `justfile` for running development tasks
+- Update documentation to reference `just` commands
+
 ### Documentation
 
 - Migrate docs deployment to AWS OIDC authentication and AWS CLI

diff --git a/Makefile b/Makefile
diff --git a/docs/Makefile b/docs/Makefile