Installation #
Fertige Binaries und ein Homebrew-Tap sind in Arbeit. Bis dahin baust du aus dem Quellcode mit Go 1.26 oder neuer:
git clone https://github.com/KilicerDev/trackr.git
cd trackr/cli
go build -o trackr .
mv trackr /usr/local/bin/Anmelden #
trackr login --server https://app.trackr.devlogin prüft den Server, öffnet deinen Browser und empfängt das Token auf einem Loopback-Port. Das Token landet im Schlüsselbund des Systems (macOS Keychain, GNOME Keyring, Windows Credential Manager). Ohne Schlüsselbund fällt es auf eine 0600-Datei zurück und warnt dich.
Optionen: --no-browser gibt die URL aus, statt sie zu öffnen; --token speichert ein vorhandenes Token.
Befehle #
trackr allein im Terminal öffnet das TUI. In einer Pipe gibt es die Hilfe aus.
| Befehl | Beschreibung |
|---|---|
trackr whoami [--json] | Wer du bist, welcher Server, Organisationen und aktive Bereiche. |
trackr task list [--scope mine\|all] [--project KEY] [--status …] | Aufgaben auflisten. |
trackr task create --title … [--project KEY] [--priority …] [--type …] [--due YYYY-MM-DD] [--estimate MIN] [--tag …] [--assignee …] | Aufgabe anlegen. -m "Titel\n\nText" setzt Titel und Beschreibung zugleich. |
trackr task view <ref> | Aufgabe per SCM-12 oder ID anzeigen. |
trackr task done <ref> | Aufgabe als erledigt markieren. |
trackr task comment <ref> -m "…" | Aufgabe kommentieren. |
trackr ticket list [--segment mine\|watched\|all] [--status …] | Tickets nach letzter Aktivität. |
trackr ticket create --org <slug> --subject "…" -m "…" | Ticket öffnen. |
trackr ticket view <ref> | Ticket mit Nachrichten. |
trackr ticket update <ref> [--status …] [--priority …] [--category …] | Ticketfelder ändern. |
trackr ticket message <ref> -m "…" [--internal] | Antworten, oder eine Team-Notiz hinzufügen. |
trackr project list | Sichtbare Projekte. |
trackr inbox [--unread] [--limit N] | Benachrichtigungen. |
trackr inbox read [id…] [--all] | Benachrichtigungen als gelesen markieren. |
trackr search <query> | Alles durchsuchen. |
trackr logout | Gespeichertes Token vergessen. |
Jeder Befehl akzeptiert --server <url> und --verbose. Status, Prioritäten, Typen und Kategorien verwenden dieselben Werte wie die API.
Maschinenlesbare Ausgabe #
Hänge --json an jeden Listen- oder Anzeige-Befehl. Die Ausgabe ist die exakte Serverantwort, keine Neukodierung.
trackr task list --scope mine --json | jq -r '.[] | "\(.ref)\t\(.title)"'Exit-Codes: 0 ok · 1 API- oder Netzwerkfehler · 2 Bedienfehler · 3 Anmeldung nötig · 4 nicht gefunden.
Konfiguration #
Die Konfigurationsdatei liegt unter $XDG_CONFIG_HOME/trackr/config.toml oder ~/.config/trackr/config.toml.
server = "https://app.trackr.dev"
default_project = "SCM"
# "keyring" (Standard) oder "file"
token_storage = "keyring"Umgebungsvariablen überschreiben die Datei: TRACKR_SERVER, TRACKR_DEFAULT_PROJECT und TRACKR_LOG=debug für Request-Logging. Rangfolge: Flag › Env › Config › Standard.
Das TUI #
Das TUI zeigt Aufgaben, Tickets, den Posteingang und die Suche in Bereichen, mit Detailseiten, Formularen und Bestätigungen. Unter 100 Spalten blendet es die Seitenleiste aus, unter 110 den Detailbereich; das Minimum ist 80×20. Live-Updates stehen auf der Roadmap; r aktualisiert.