Behavior Log

Use scripts/behavior_log.py to insert one record into behavior_logs or read recent logs.

Run

uv run scripts/behavior_log.py write good --coach-comment "Kept focus"

uv run scripts/behavior_log.py write bad --pavlok-log '{"stimulusType":"zap","stimulusValue":30}'

echo '{"stimulusType":"beep","stimulusValue":100}' | uv run scripts/behavior_log.py write bad --pavlok-log -

uv run scripts/behavior_log.py write good --related-date 2026-01-26

uv run scripts/behavior_log.py read 2

Inputs

• write mode: behavior must be good or bad.
• write mode: --related-date accepts YYYY-MM-DD or YYYYMMDD.
• write mode: --pavlok-log expects a JSON object string; use - to read from stdin.
• write mode: --coach-comment is optional free text.
• read mode: days is a positive integer (1 = today, 2 = today + yesterday).

Outputs

Write mode prints a single line of JSON:

{"id": 10}

Read mode prints a JSON array:

[{"id": 10, "behavior": "good", "related_date": "2026-01-26", "pavlok_log": null, "coach_comment": null, "created_at": "2026-01-26T09:00:00"}]

Notes

• Database URL comes from DATABASE_URL (default: sqlite:///./app.db).