https://github.com/rollecode/focus-timer
A beautiful floating flow timer for deep work sessions, designed for Claude Code integration.
https://github.com/rollecode/focus-timer
claude-code flow-timer focus focus-timer mac-app
Last synced: 27 days ago
JSON representation
A beautiful floating flow timer for deep work sessions, designed for Claude Code integration.
- Host: GitHub
- URL: https://github.com/rollecode/focus-timer
- Owner: rollecode
- Created: 2026-03-25T15:05:29.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-03-26T16:06:45.000Z (2 months ago)
- Last Synced: 2026-05-02T13:33:29.541Z (28 days ago)
- Topics: claude-code, flow-timer, focus, focus-timer, mac-app
- Language: Swift
- Homepage:
- Size: 5.59 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
🎯 Focus Timer
A beautiful floating flow timer for deep work sessions
---
## What is Focus Timer?
A native macOS floating widget that counts **up** toward an estimated duration. No hard stops - the timer keeps running into overtime. A tibetan singing bowl rings at the halfway point and when estimated time is reached. The living gradient background shifts from purple to orange (halfway) to red (overtime) to gray (paused).
## Install
```bash
git clone https://github.com/ronilaukkarinen/focus-timer.git
cd focus-timer
swift build -c release
cp .build/release/focus-timer /opt/homebrew/bin/focus-timer
```
## Usage
```bash
focus-timer --name "Deep work: KM-108 TTS" --time 45
```
| Argument | Default | Description |
|----------|---------|-------------|
| `--name` | `Focus` | Task name displayed in the widget |
| `--time` | `25` | Estimated duration in minutes |
| Key | Action |
|-----|--------|
| Space | Pause / Resume |
| Enter | Complete and close |
| State | Background | Trigger |
|-------|------------|---------|
| Normal | Purple | 0-49% |
| Halfway | Orange | 50-99% + bell |
| Overtime | Red | 100%+ bell |
| Paused | Gray | Space key |
## Claude Code integration
Designed to be launched by Claude Code during daily planning. Add to your planner command:
```
When scheduling deep work blocks, launch the focus timer in the background:
focus-timer --name "Task name" --time &
```
## Requirements
- macOS 13 or later