# task-master

Offline-first Terminal-Taskmanager (`tm`) — Kanban-Board, Markdown-Tickets, Checklisten, Zeiterfassung und Reports. Gebaut mit [Bubble Tea](https://github.com/charmbracelet/bubbletea).

![Demo](demo.gif)

> Demo wird aus [`demo.tape`](demo.tape) erzeugt (`make demo`). Ohne GIF lokal: siehe [Demo aufnehmen](#demo-aufnehmen).

## Features

- Projekte & Tickets lokal als JSON (kein Server)
- Board-Filter: All / Backlog / In Progress / Done
- Tickets in `$EDITOR` bearbeiten (Markdown + Checklisten)
- Timer, manuelle Zeitbuchungen, Zeiteinträge verwalten
- Report mit Group-by (Ticket / Tag)
- Undo / Redo über eine Command-History
- Vim-Style Keybindings

## Install

Voraussetzung: Go (siehe `go.mod`).

```bash
git clone git@git.aloxdrim.de:skruecken/task-master.git
cd task-master
make install          # → $(go env GOPATH)/bin/tm
# oder nur bauen:
make build            # → ./bin/tm
```

## Nutzung

```bash
tm                    # TUI starten
tm version            # Build-Version (Git-Hash)
tm help
```

Sandbox ohne echte Config/Daten:

```bash
make run-dev          # nutzt ./.dev-home
# oder:
TASK_MASTER_HOME=/tmp/tm-sandbox tm
```

Daten landen standardmäßig unter `~/.local/share/task-master`, Config unter `~/.config/task-master`.

| Variable             | Wirkung                                      |
|----------------------|----------------------------------------------|
| `TASK_MASTER_HOME`   | Basis für Config + Daten (Dev/Demo)          |
| `TASK_MASTER_DATA_DIR` | Nur Datenverzeichnis überschreiben         |

## Keybindings (Auszug)

| Taste   | Aktion                |
|---------|------------------------|
| `j`/`k` | Navigieren             |
| `n`     | Neues Ticket/Projekt   |
| `e`     | Ticket im Editor       |
| `s`     | Status ändern          |
| `l`     | Board-Filter           |
| `/`     | Suche                  |
| `p`/`P` | Projekt / Ticket verschieben |
| `t`/`T` | Timer / Zeit buchen    |
| `m`     | Zeiteinträge           |
| `r`     | Report                 |
| `x`/`X` | Löschen / Force-Delete |
| `u`/`U` | Undo / Redo            |
| `q`     | Beenden                |

Checklisten im Preview: `J`/`K` + `Space`.

## Entwicklung

```bash
make test
make build
make version
```

## Demo aufnehmen

Die Walkthrough-Aufnahme steckt in [`demo.tape`](demo.tape) ([VHS](https://github.com/charmbracelet/vhs)):

```bash
# einmalig: vhs + ttyd/ffmpeg (siehe VHS-Docs)
make demo             # schreibt demo.gif (+ demo.mp4)
```

Die Pipeline erzeugt das GIF ebenfalls und lädt es als Artifact hoch.

## Lizenz

Privat / eigener Use — siehe Repository-Einstellungen auf Gitea.