brief
Lists the files in the folder. No model needed.
A local tool for one Python folder
python-vibe is a command-line tool. You point it at one Python project. It can answer a question, write a unit test, fix a failing test, or add a small function. It only reads and writes files in that folder.
Commands
ask
Answers a question. Does not change files.
run
Changes files, then runs the tests.
Try it
demo/orders is the sample project. Activate the virtualenv first
(source .venv/bin/activate). If the shell says command not found,
the virtualenv is not active.
source .venv/bin/activate
cd demo/orders
python-vibe brief
python-vibe ask "what does compute_total return?"
python-vibe run "write tests for apply_discount"
python-vibe run "find the NameError and fix it"
python-vibe run "add a function total_lines and a test"
Do not run brief on the python-vibe repository root. That scans
hundreds of files. Another project:
python-vibe ask ~/app "what does add return?".
On a large project add --scope src. Full install steps:
Start.
This site
| Page | What is on it |
|---|---|
| Start | Install, then the four commands |
| Commands | Every flag, the Python API, and the local HTTP server |
| Live | A recorded session |
| Demo | Eleven sample tasks and what happened |
| Folders | What each directory in this repository is |
| Editors | VS Code and Cursor |
| Results | Measured scores |
| Architecture | How src/harness/ is layered |
Limits
It does not browse the web or run arbitrary shell commands. run keeps
a .bak of each file it edits. The NameError and total_lines samples
on demo/orders are built into the tool; they do not call a model.