Anleitung

Alles, was du brauchst – in der Reihenfolge, in der du es brauchst.

Erste Schritte

Lade Hatch, installiere es und erstelle ein Konto. Das Onboarding legt dein erstes Projekt an. Jedes Projekt hat ein Kürzel (z. B. HAT), Aufgaben heißen dann HAT-1, HAT-2 … Diese Referenzen nutzt du in Commits, Notizen und im Gespräch mit Agenten.

Hinterlege in den Projekteinstellungen den lokalen Ordner deines Codes – dann starten VS Code, Terminal, Claude Code und Codex direkt im Projekt (Button „Arbeiten“).

Schnell notieren

Drück überall in Windows Strg Alt Leertaste, tipp einen Gedanken, Enter. Beispiele:

morgen Logo-Entwurf an Lisa schicken #portfolio → Aufgabe im Projekt „Portfolio“, fällig morgen
Erinnere mich Freitag um 15 Uhr an die Steuer → Erinnerung mit Windows-Benachrichtigung
Claude soll die Tests für den Login schreiben → Aufgabe für Claude, landet in der Agenten-Warteschlange

Mit # wählst du ein Projekt direkt. Ohne Internet wird zwischengespeichert und später gesendet.

Claude Code verbinden

Ein Klick: In der App → Agenten → Tab „Claude Code“ → Automatisch einrichten. Hatch legt ein persönliches Token an, registriert den MCP-Server und installiert den Skill hatch.

Manuell (Token unter Einstellungen → Claude & Codex erzeugen):

claude mcp add --transport http --scope user hatch https://api.hatch.wisak.at/mcp \
  --header "Authorization: Bearer <DEIN_TOKEN>"

Danach in Claude Code: /mcp__hatch__work – oder einfach „Schau in Hatch, was zu tun ist, und mach es.“

Codex verbinden

Ein Klick: Agenten → Tab „Codex“ → Automatisch einrichten. Hatch trägt sich in ~/.codex/config.toml ein und ergänzt ~/.codex/AGENTS.md um den Arbeitsablauf.

Manuell in %USERPROFILE%\.codex\config.toml:

[mcp_servers.hatch]
url = "https://api.hatch.wisak.at/mcp"
http_headers = { "Authorization" = "Bearer <DEIN_TOKEN>", "X-Hatch-Agent" = "codex" }

Der Agenten-Workflow

Projekt finden (hatch_resolve_project mit dem aktuellen Ordner)
Kontext lesen: offene Aufgaben, letzte Übergabe, Notizen, Commits
Aufgabe starten, umsetzen, testen, committen mit fixes HAT-12
Aufgabe abschließen, Folgeaufgaben anlegen, Doku schreiben
Immer eine Übergabe schreiben – die nächste Session macht dort weiter

Werkzeug	Wofür
`hatch_resolve_project`	Projekt zum aktuellen Ordner / Git-Remote finden
`hatch_get_context`	Offene Aufgaben, Übergaben, Notizen, Commits als Markdown
`hatch_next_tasks`	Priorisierte Aufgaben – dir zugewiesene zuerst
`hatch_start_task / hatch_complete_task`	Aufgabe beginnen / mit Zusammenfassung abschließen
`hatch_create_task / hatch_update_task`	Aufgaben & Unteraufgaben anlegen, ändern, Checklisten abhaken
`hatch_write_doc / hatch_list_notes`	Dokumentation als Notiz schreiben oder ergänzen
`hatch_log_session`	Übergabe: erledigt, als Nächstes, Blocker, Commits
`hatch_checklists, hatch_search, hatch_today, hatch_remind`	Checklisten, Suche, Tagesüberblick, Erinnerungen
`hatch_create_project / hatch_link_project`	Projekt anlegen oder mit Ordner & Repo verknüpfen

Markiere Aufgaben mit „Für Claude“, „Für Codex“ oder „Irgendein Agent“ – sie stehen dann oben in hatch_next_tasks.

GitHub

Erstelle ein Personal Access Token mit repo und read:user und füg es unter Einstellungen → Verbindungen ein. Danach im Projekt → Git → Repo wählen. Hatch prüft alle drei Minuten auf neue Commits, Pushes und PRs. Für sofortige Updates: Webhook auf https://api.hatch.wisak.at/v1/github/webhook (Content-Type application/json).

Ein Commit mit fixes HAT-12, closes HAT-12 oder erledigt HAT-12 hakt die Aufgabe automatisch ab.

KI (Gemini)

Hol dir einen kostenlosen Key in Google AI Studio und füg ihn unter Einstellungen → KI ein. Der Key wird verschlüsselt auf dem Server gespeichert. Die KI liefert: Tages-Briefing, Chat mit Werkzeugen (Strg J), Einsortieren von Schnellnotizen, Auto-Planung, Aufgaben-Zerlegung, Commit- und Wochenrückblicke.

Kalender

Hatch → Kalender-App: Einstellungen → Kalender → Abonnieren. Apple Kalender am Mac: Ablage → Neues Kalenderabonnement. iPhone: Einstellungen → Kalender → Accounts → Account hinzufügen → Andere → Kalenderabo hinzufügen.

Kalender → Hatch: Füg einen ICS-Link hinzu (iCloud: Kalender teilen → Öffentlicher Kalender). Termine erscheinen im Kalender und Planer, die Auto-Planung plant um sie herum.

Tastenkürzel

`Strg` `Alt` `Leertaste`	Schnell notieren (überall)
`Strg` `Alt` `H`	Hatch zeigen/verstecken
`Strg` `Alt` `F`	Fokus-Timer
`Strg` `K`	Befehlspalette & Suche
`Strg` `J`	KI-Assistent
`N`	Neue Aufgabe
`Strg` `1` … `9`	Bereiche wechseln
`?`	Alle Kürzel

API

Alles, was die App kann, geht auch per REST: https://api.hatch.wisak.at/v1. Authentifizierung mit Authorization: Bearer <token>. Kurzreferenz: https://api.hatch.wisak.at/v1/docs.

# Aufgabe anlegen
curl -X POST https://api.hatch.wisak.at/v1/tasks \
  -H "Authorization: Bearer $HATCH_TOKEN" -H "Content-Type: application/json" \
  -d '{"title":"Release vorbereiten","dueAt":"2026-11-10"}'

# Gedanke einsortieren lassen
curl -X POST https://api.hatch.wisak.at/v1/captures -H "Authorization: Bearer $HATCH_TOKEN" \
  -H "Content-Type: application/json" -d '{"text":"morgen Backup testen #server"}'

Live-Änderungen gibt es als Server-Sent Events unter /v1/events.