# Task Tracking Dots HTML

> Manages task tracking with the HTML-backed Dots fork from Randroids-Dojo/dots-html. Use when tracking work items across sessions with dot-html CLI files stored as .html documents.

- Skill: `randroids-dojo/task-tracking-dots-html` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds add randroids-dojo/task-tracking-dots-html`
- Raw SKILL.md: https://api.skillmd.com/api/skills/randroids-dojo/task-tracking-dots-html/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: randroids-dojo (https://skillmd.com/u/randroids-dojo)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/randroids-dojo/task-tracking-dots-html

---


# Task Tracking with HTML Dots

Use the `dot-html` CLI from `Randroids-Dojo/dots-html` to track work items across sessions. This fork stores dots as `.html` documents under `.dots/`.

## Preflight

Check for the CLI:

```bash
command -v dot-html >/dev/null 2>&1 && dot-html --version
```

If `dot-html` is missing, install this fork:

```bash
scripts/install-html-dots.sh
```

Resolve that path from the directory containing this `SKILL.md`; do not assume the target project's working directory contains the script. If the release has no matching binary asset for the current OS/architecture, the script clones `https://github.com/Randroids-Dojo/dots-html` and builds with Zig.

## Session Workflow

At the start of every session:

```bash
dot-html ls
dot-html ready
```

Before starting work:

```bash
dot-html on <id>
```

After completing work:

```bash
dot-html off <id> -r "What was done"
```

Never leave completed tasks open. Close with a short reason.

## Creating Dots

```bash
dot-html "Fix the bug"
dot-html add "Design API" -p 1 -d "Details"
dot-html add "Subtask" -P dots-1
dot-html add "After X" -a dots-2
```

## Inspecting Work

```bash
dot-html ls
dot-html ready
dot-html show dots-1
dot-html tree
dot-html find "query"
```

## File Storage

New dots are stored as HTML files:

```text
.dots/
  dots-example-1234abcd.html
  dots-parent-2345bcde/
    dots-parent-2345bcde.html
    dots-child-3456cdef.html
```

The CLI owns these files. Prefer `dot-html` commands for changes so status, dependencies, archive moves, and parent-child paths stay consistent.