pavlok

The pavlok skill allows for direct interaction with Pavlok wearable devices, enabling users to trigger physical stimuli such as vibrations, beeps, or zaps programmatically. This agent is designed for individuals seeking to enforce behavioral changes or provide real-time accountability for productivity goals. By integrating with the Pavlok API, it serves as a reinforcement mechanism that can be triggered by scripts or automated workflows to discourage procrastination or incentivize task completion.

• Trigger multiple stimulus types: vibe, beep, and zap to suit the desired intensity of feedback.

• Leverages the Pavlok API for secure and authenticated device communication.

• Designed for habit reinforcement, goal commitment, and real-time behavioral correction.

• Supports integration into larger automation pipelines, such as Slack-based coaching bots or custom task management systems.

• Requires a valid Pavlok API key, which can be generated via the official Pavlok authentication portal.

• Configure the .env file with PAVLOK_API_KEY to authorize API requests.

• For 'zap' actions, the system enforces safety constraints using PAVLOK_API_KEY, LIMIT_DAY_PAVLOK_COUNTS, and LIMIT_PAVLOK_ZAP_VALUE environment variables.

• If daily limits are reached or a zap value exceeds the user-defined threshold, the script will return a response object indicating the 'skipped' status to prevent excessive or unsafe stimulus.

• The script interface requires a stimulus type (string), a stimulus value (integer), and a descriptive reason string for logging purposes, although the API itself currently focuses on the trigger execution.

• This tool is best utilized alongside other coaching or productivity agents to create a comprehensive accountability system that bridges software task tracking with physical wearable feedback.