---

name: behavior-log description: Insert or read behavior log rows in the local database (behavior_logs). Use when recording a good/bad behavior entry, attaching a Pavlok API response JSON, adding a coach comment, or fetching recent logs via scripts/behavior_log.py.

Behavior Log

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

Run

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

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

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

Copyuv run scripts/behavior_log.py read 2

Inputs

• write mode: behavior must be good or bad.
• 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).

Notes

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