DEVELOPING.md

Python development

Install on Install your virtualenv with

    python3 -m venv .venv
    . .venv/bin/activate
    pip install -e .

Extra skills for codex

    rtk init --codex
    npx skills add JuliusBrussee/caveman -a codex

Unit test Run

python3 -m unittest discover -s tests && pylint $(git ls-files '*.py')

Dockerized test run

To just populate a throw-away database:

FIND_HOME=/tmp docker compose up --build

AI Tips

To check token usage use something like

npx ccusage 

Caveman skills

To install caveman we used

npx skills add JuliusBrussee/caveman -a codex
# Also install rtk command to further reduce token usage
brew install rtk