# Focus Block

> Pomodoro-aware focus session manager with DND and journal logging.

- Skill: `sahit-sai/focus-block` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add sahit-sai/focus-block`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sahit-sai/focus-block/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: sahit-sai (https://skillmd.com/u/sahit-sai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sahit-sai/focus-block

---


# focus-block

## Purpose

Starts and ends Pomodoro-style focus sessions, toggles Do Not Disturb when available, and records the work in a markdown journal.

## Runbook

1. Set `JOURNAL_PATH` (default: `~/notes/focus-log.md`); create the file if absent.
2. Check whether a session is already open by looking for `status: open` in the journal.
3. Run `scripts/start-session.sh "task description"` to open a new session. The script generates a session ID, appends a journal record, and attempts to enable DND.
4. Work for 25 minutes; the start script prints the standard Pomodoro reminder.
5. Run `scripts/end-session.sh` to close the active session and record its duration.
6. After every 4 completed Pomodoros, suggest a 20-minute break.
7. Run `scripts/status.sh` at any time to review today’s focus history.

## Stop conditions

1. Warn but do not abort if DND integration is unavailable.
2. Abort if `JOURNAL_PATH` resolves to a directory.
3. Do not allow two open sessions simultaneously; abort with an informative message.
4. Never delete journal entries.

## Output format

A completed journal entry appended to `JOURNAL_PATH`:

```
## Focus Session 20240615-a3f1
- task: Write architecture doc
- start: 2024-06-15T14:30:00
- end: 2024-06-15T14:55:00
- duration_minutes: 25
- status: complete
```

## Example invocations

- `JOURNAL_PATH=~/notes/focus-log.md skills/focus-block/scripts/start-session.sh "write SKILL.md docs"`
- `skills/focus-block/scripts/end-session.sh`
- `skills/focus-block/scripts/status.sh`
- "Start a 25-minute focus block for writing the weekly brief."