build: Migrate from Makefile to justfile

.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'

AGENTS.md

@@ -49,7 +49,7 @@ uv pip install --editable . -G dev
 
 ```bash
 # Run all tests
-make test
+just test
 # or directly with pytest
 uv run pytest
 
@@ -60,7 +60,7 @@ uv run pytest tests/test_pane.py
 uv run pytest tests/test_pane.py::test_send_keys
 
 # Run tests with test watcher
-make start
+just start
 # or
 uv run ptw .
 
@@ -72,26 +72,26 @@ uv run ptw . --now --doctest-modules
 
 ```bash
 # Run ruff for linting
-make ruff
+just ruff
 # or directly
 uv run ruff check .
 
 # Format code with ruff
-make ruff_format
+just ruff-format
 # or directly
 uv run ruff format .
 
 # Run ruff linting with auto-fixes
 uv run ruff check . --fix --show-fixes
 
 # Run mypy for type checking
-make mypy
+just mypy
 # or directly
 uv run mypy src tests
 
 # Watch mode for linting (using entr)
-make watch_ruff
-make watch_mypy
+just watch-ruff
+just watch-mypy
 ```
 
 ### Development Workflow
@@ -108,13 +108,13 @@ Follow this workflow for code changes:
 
 ```bash
 # Build documentation
-make build_docs
+just build-docs
 
 # Start documentation server with auto-reload
-make start_docs
+just start-docs
 
 # Update documentation CSS/JS
-make design_docs
+just design-docs
 ```
 
 ## Code Architecture

CHANGES

@@ -32,6 +32,13 @@ $ uvx --from 'libtmux' --prerelease allow python
 
 <!-- To maintainers and contributors: Please add notes for the forthcoming version below -->
 
+### Development
+
+#### Makefile -> Justfile (#617)
+
+- Migrate from `Makefile` to `justfile` for running development tasks
+- Update documentation to reference `just` commands
+
 ### Documentation
 
 Move documentation deployment to GitHub OIDC and AWS CLI.