Skip to content

Latest commit

 

History

History

typescript

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

README.md

Pomodoro Timer with Electron and SLOP

A desktop Pomodoro timer that is also a SLOP provider. An AI consumer can observe timer state, start/pause sessions, and read session history through a Unix socket.

Prerequisites

  • Node.js 18+
  • bun

Install

bun install

Seed data

Copy the sample sessions so the app starts with history:

mkdir -p ~/.pomodoro && cp seed.json ~/.pomodoro/sessions.json

Run

bunx electron .

Connect a CLI consumer

go run ../../../cli --connect /tmp/slop/pomodoro.sock

SLOP provider

The app automatically starts a SLOP provider on launch:

  • Socket: /tmp/slop/pomodoro.sock
  • Discovery: ~/.slop/providers/pomodoro.json
  • Capabilities: state, patches, affordances, attention

The provider exposes timer state, session history, and daily stats. Available actions change based on the current timer phase (idle, working, paused, break).