Add README and Gitea CI with demo artifact upload.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-19 19:08:32 +02:00
parent 81f2902ff1
commit 214ae1e0cf
4 changed files with 167 additions and 2 deletions
@@ -0,0 +1,95 @@
+# 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.