📘 Roadmap · 📝 Release Notes
A tiny build system that fits in your pocket.
Because not everything needs a toolchain.
The self-contained executable script lives at bin/pocket-build.py.
The only requirement is Python 3.10+ — no pip, no dependencies.
Download or copy that one file anywhere and run it directly:
python3 pocket-build.pyThat’s it. ✨
Everything else in this repo (tests, docs, configs) exists only for developing and maintaining the script itself.
Pocket-Build includes a built-in self-check — no pytest required.
You can verify that the script works correctly on your system by running:
python3 pocket-build.py --selftestThis creates a tiny temporary project, copies a test file, and confirms it completes successfully.
If you see a ✅ “Self-test passed” message, your installation is working perfectly.
You’re free to use, copy, and modify the script under the standard MIT terms.
The additional rider simply requests that this project not be used to train or fine-tune AI/ML systems until the author deems fair compensation frameworks exist.
Normal use, packaging, and redistribution for human developers are unaffected.
If you prefer a direct executable:
chmod +x pocket-build.py
./pocket-build.pyYou can even drop it somewhere on your PATH for easy use.
You don’t need a native build.
Python 3 ships with most Linux distributions. On Mac, it's one homebrew command away. On Windows, running the script automatically prompts the user to install Python from the Microsoft Store.
Pocket-build is meant to live comfortably next to your other tools — Go, Node.js, Rust, whatever — when all you need is a simple, dependency-free way to copy and package files.
Use it. Hack it. Ship it. It’s MIT-licensed, minimal, and meant to stay out of your way — just with one polite request: don’t feed it to the AIs (yet).
✨ AI was used to help draft language, formatting, and code — plus we just love em dashes.