task-tracking-dots-html git:20260513.f2ec394A

Immutable. This exact content is served forever at /api/v1/blob/a258dfa60a4b4a71.

---
name: task-tracking-dots-html
description: Manages task tracking with the HTML-backed Dots fork from Randroids-Dojo/dots-html. Use when tracking work items across sessions with dot CLI files stored as .html documents.
compatibility: Requires curl and either a matching GitHub release asset or Zig 0.15+ for source builds.
---

# Task Tracking with HTML Dots

Use the `dot` 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 >/dev/null 2>&1 && dot --version
```

If `dot` is missing or is the markdown-backed upstream build, install this fork:

```bash
plugins/task-tracking-dots-html/scripts/install-html-dots.sh
```

When installed from a global skill, run the script from the installed skill directory. 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 ls
dot ready
```

Before starting work:

```bash
dot on <id>
```

After completing work:

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

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

## Creating Dots

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

## Inspecting Work

```bash
dot ls
dot ready
dot show dots-1
dot tree
dot 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` commands for changes so status, dependencies, archive moves, and parent-child paths stay consistent.