Development
Every check runs in Docker through the Makefile. Run make help for the full list.
| Command | Does |
|---|---|
make build | Build psyb0t/auto-linux-desk:latest. |
make build-test | Build the test-tagged image. |
make dev-image | Build the runtime image and a development image on top of it with ruff, shellcheck, the Docker CLI and the security tools. |
make shell | Open a shell in the development image. |
make lint | ruff check, ruff format check and shellcheck. |
make format, make lint-fix | Apply ruff formatting and safe fixes. |
make test-unit | Every tests/test_*.py in a read-only container. |
make test | Build a test image and run the integration suite in test.sh against real containers. Pass names to run some: make test TEST_ARGS="test_keybindings test_run_command". |
make sec | semgrep, bandit and pip-audit, merged into sec.sarif. |
make docs-build | Build this site with the GitHub Pages image into .testing/docs-site. |
make clean | Remove this project’s local images. |
Layout
| Path | Holds |
|---|---|
src/autolinuxdesk/ | The server package: registry, actions, MCP tools, input planners and executor, windows, processes, key bindings. |
entrypoint.sh | Ownership fixes, root hooks, privilege drop, Xvfb, Openbox, VNC and the server. |
docker/configure-openbox.py | Writes the Openbox config and its key bindings at build time. |
tests/ | Unit tests (test_*.py), integration modules (test_*.sh) and test apps, including a tk window that logs X input events. |
The integration tests measure humanized input through a real X client: the event logger records pointer motion, button holds, double-click recognition, typed characters and wheel notches, and the tests check them against human ranges.