A modern work timer with AI-powered recommendations. Get smart timer settings based on your goals, plus beautiful design and focus features.
- 🤖 AI Assistant - Describe your goal, get smart timer recommendations
- 🎯 8 Presets - Study, Deep Work, Creative, Coding, Meeting, Writing, Research, Exercise
- ⏱️ Flexible Timer - Custom work/break intervals, session names, progress tracking
- 🔔 Smart Notifications - Desktop alerts and audio feedback
- 🎨 Modern Design - Clean interface, responsive for all devices
- 📊 Session History - Track your daily productivity
- 🔒 Privacy Focused - All data stays local, timer hide mode
Visit timer.toxi360.org to use PulseTimer directly in your browser. No installation required!
- Clone the repository:
git clone https://github.com/Efeckc17/PulseTimer.git
cd PulseTimer
- Install dependencies:
npm install
- Set up AI (optional):
echo "OPENROUTER_API_KEY=your_key_here" > .env
- Start the server:
npm start
- Open your browser and visit:
http://localhost:5678
AI Setup (Optional): Get a free API key from OpenRouter for AI recommendations. Works fine without it too!
- Frontend: HTML5, CSS3, JavaScript (ES6 modules)
- Backend: Node.js, Express
- AI: OpenRouter API (GPT-3.5-turbo)
- Audio: Web Audio API
- Notifications: Web Notifications API
- Security: Helmet.js
- AI Assistant: Click the floating button → describe your goal → get recommendations
- Manual Setup: Set work duration, break intervals, session name
- Start Timer: Play/pause/reset, track progress
- Smart Breaks: Auto breaks with notes, skip if needed
- History: Check your daily sessions in settings
Found a bug? Want a feature? PRs welcome!
- Fork the repo
- Make your changes
- Submit a PR
- ⭐ Star the repo
- ☕ Buy me a coffee
- 🐛 Report issues
PulseTimer is licensed under the Apache License 2.0.
Made with ❤️ by @Efeckc17