# Holocube Pomodoro Trackers

> Run the HoloCube Pomodoro “OS” UI (tracker bar + centered label + lobster) and control water/exercise/focus/pills live. Use when this capability is needed.

- Skill: `tomevault-io/holocube-pomodoro-trackers` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/holocube-pomodoro-trackers`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/holocube-pomodoro-trackers/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/holocube-pomodoro-trackers

---


## What this skill does

The implementation lives in the **HoloClawd firmware repo**:

- `https://github.com/andrewjiang/HoloClawd-Open-Firmware`

It includes a template “OS” layout for the HoloCube:

- **Top**: a tracker bar (icons + counts + pixel border)
- **Middle**: centered app label + smaller timer
- **Bottom**: lobster mascot (animated / confetti on breaks)

The Pomodoro app uses this layout and supports live tracker updates.

## Run Pomodoro

Clone the firmware repo and run from its root:

```bash
git clone https://github.com/andrewjiang/HoloClawd-Open-Firmware.git
cd HoloClawd-Open-Firmware
```

Then:

```bash
uv run --script examples/pomodoro.py --ip <HOLOCUBE_IP> --task "DEEP WORK"
```

Useful flags:

- `--work 25 --short 5 --long 15 --sessions 4`
- `--focus-text "BUILD"`
- **Trackers (starting values)**:
  - `--water 0` (water count)
  - `--exercise 0` (exercise count)
  - `--focus 0` (focus count)
  - `--pills` (mark supplements as done)

## Live tracker commands (while Pomodoro is running)

Type these into the terminal running Pomodoro (press Enter after each):

- **Increment**:
  - `w` or `water` → +1 water
  - `e` or `exercise` → +1 exercise
  - `f` or `focus` → +1 focus
- **Toggle pills**:
  - `p` or `pills` → toggle “supplements done”
- **Set an exact value**:
  - `set water 3`
  - `set exercise 1`
  - `set focus 10`
  - `set focus 0` (reset focus back to 0)
- **Help / quit**:
  - `help`
  - `q`

### Auto focus increment

Each time a **work session completes**, Pomodoro automatically increments the **focus** tracker by +1.

## Notes

- The tracker icons are PNGs stored in-repo under `assets/icons/...` and rendered efficiently via run-length encoded draw commands.
- HoloCube communication uses the REST draw API (batch mode + chunking for ESP8266 stability).

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/andrewjiang) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->