DailyStruggleOS Starter Kit

Short Intro

DailyStruggleOS is a local-first starter kit for building a personal AI Chief of Staff around ordinary life: inbox, documents, money admin, ideas, projects, decisions and weekly reviews. It is agent-native, file-based, privacy-aware and designed to work with tools like Codex, Claude Code, Cursor, OpenCode, OpenClaw, Hermes and similar local agents.

It is not AI magic. It becomes useful when the user talks to the agent, adds context, drops material into the workspace and corrects mistakes. The point is not to replace judgment; the point is to give the agent a stable local memory and a calm operating rhythm.

Kurzinfo

DailyStruggleOS ist ein local-first Starter Kit für einen persönlichen AI Chief of Staff: Inbox, Dokumente, Geld-Admin, Ideen, Projekte, Entscheidungen und Reviews in einem einfachen lokalen Ordner. Es ist agent-native, dateibasiert, privacy-bewusst und funktioniert mit Codex, Claude Code, Cursor, OpenCode, OpenClaw, Hermes und ähnlichen lokalen Agenten.

The name is playful; the purpose is practical. Viele Menschen scheitern nicht an fehlender Disziplin, sondern an zu vielen verstreuten offenen Schleifen.

Der Kern ist einfach: ein Ordner mit klaren Bereichen, ein kurzer Boot-Prozess für deinen AI-Agenten und ein lokales Gedächtnis, das dir hilft, Dinge zu sortieren, Entscheidungen festzuhalten und den nächsten sinnvollen Schritt zu sehen.

DailyStruggleOS ist kein Tracking- oder Optimierungs-System. Es ist ein ruhiger AI Chief of Staff für echtes Leben: lokal, privat, dateibasiert und dir gehörend.

Language

The starter docs are partly German because the original use case was German. Agents should not force German. They should mirror the user's language, translate setup prompts when useful and keep generated local files in the language the user prefers.

Für Wen

DailyStruggleOS ist für:

• normale Menschen mit zu vielen offenen Schleifen
• Selbstständige, Angestellte, Eltern, Studierende und Haushalte
• Power User, die ihr eigenes lokales System erweitern wollen
• Menschen, die AI nutzen möchten, ohne ihr ganzes Leben in eine Cloud-App zu kippen
• Nutzer von Codex, Claude, Cursor, OpenCode, OpenClaw, Hermes und anderen Coding- oder AI-Agenten

DailyStruggleOS ist nicht:

• ein Cloud-Dashboard
• ein automatisches Tracking-System
• ein Spekulations-, Anlageberatungs- oder Finanzprodukt
• Rechts-, Steuer-, Finanz- oder Medizinberatung
• ein Ersatz für dein eigenes Urteil

Was Enthalten Ist

• START_HERE.md - der einfachste Einstieg für ZIP- oder GitHub-Nutzer
• AGENTS.md - allgemeiner Vertrag für AI-Agenten
• CLAUDE.md - kleiner Claude-Code-Adapter, der AGENTS.md importiert
• .dailystruggleos/ - Boot, Privacy, Chief-of-Staff-Rolle und leeres State-Template
• templates/ - Vorlagen für Inbox, Projekte, Reviews, Entscheidungen, Finanzen, Dokumente und Kontexte
• onboarding/ - geführter 15-Minuten-Start
• apps/inbox-swipe/ - optionale lokale Swipe-Oberfläche für Inbox-Triage
• docs/ - Story, Informationsarchitektur, Agent-Kompatibilität und Release-Readiness, inklusive Local-AI-Optionen
• example/ - eine kleine synthetische Beispielperson
• scripts/ - optionale lokale Setup-Skripte ohne externe Downloads

Die Arbeitsbereiche sind absichtlich schlicht:

• inbox/ für alles Neue
• ideas/ für Rohideen, spätere Bewertung und kleine Einfälle
• projects/ für Vorhaben
• work/ für Arbeit und Job-Kontext
• life/ für private Lebensbereiche
• finance/ für Budget, Rechnungen, Verträge und Steuerablage
• documents/ für Papierkram und Dokumentenlog
• decisions/ für wichtige Entscheidungen
• reviews/ für Weekly und Monthly Reviews
• archive/ für Abgelegtes

5-Minuten-Start

1. Lade DailyStruggleOS als ZIP oder GitHub-Repo herunter.
2. Öffne den Ordner in deinem AI-Agenten oder Editor.
3. Öffne START_HERE.md.
4. Kopiere diesen Prompt in deinen Agenten:

Boot DailyStruggleOS

5. Lass dich durch den ersten Mini-Start führen.

Optional kannst du die lokale Ordnerstruktur vorbereiten:

powershell -ExecutionPolicy Bypass -File scripts/setup.ps1

Oder auf macOS/Linux:

bash scripts/setup.sh

15-Minuten-Onboarding

Beim ersten Start soll dein Agent:

1. AGENTS.md und .dailystruggleos/BOOT.md lesen.
2. Die Privacy-Regeln aus .dailystruggleos/PRIVACY.md beachten.
3. Dich durch onboarding/onboarding-script.md führen.
4. Maximal die Kernfragen aus onboarding/questions.md stellen.
5. Eine private lokale .dailystruggleos/STATE.local.md anlegen, falls sie fehlt.
6. Nur die ersten nützlichen Dateien erstellen, nicht dein ganzes Leben modellieren.

Das Ziel nach 15 Minuten ist nicht Perfektion. Das Ziel ist ein ruhiger erster Stand: Was ist gerade los, was ist wichtig, was ist der nächste Schritt?

Kompatible Agenten

DailyStruggleOS ist bewusst agent-neutral. Es nutzt Markdown, klare Boot-Reihenfolge und normale Ordner statt proprietärer Datenformate. Es sollte mit diesen Tools funktionieren:

• Codex
• Claude
• Cursor
• OpenCode
• OpenClaw
• Hermes
• andere Agenten, die lokale Dateien lesen und schreiben können

Wenn dein Agent eigene Regeln unterstützt, starte trotzdem mit AGENTS.md und .dailystruggleos/BOOT.md. Diese Dateien sind der gemeinsame Vertrag. Details stehen in docs/agent-native-integrations.md.

Komplett Lokal Arbeiten

DailyStruggleOS kann auch als komplett lokales Setup genutzt werden, wenn dein Agent und dein Modell lokal laufen. Das ist interessant fuer Nutzer, die ihre Notizen, Dokumente und Inbox-Daten nicht an Cloud-Modelle senden wollen.

Praktische Wege:

• Codex CLI mit lokalem Provider: codex --oss --local-provider ollama oder codex --oss --local-provider lmstudio
• Ollama mit lokal geladenem Modell und OpenAI-kompatibler API
• LM Studio als lokaler Server auf localhost
• andere Agenten oder Editoren, wenn sie lokale Modelle oder einen OpenAI-kompatiblen Base-URL-Override sauber unterstuetzen

Lokal ist nicht automatisch besser fuer jede Aufgabe. Es ist privater und kontrollierbarer, kann aber je nach GPU, RAM, Modellgroesse und Tool-Calling langsamer oder weniger stark sein. Fuer sensible Inbox-, Dokumenten- und Lebenskontext-Arbeit ist ein lokaler oder hybrider Modus trotzdem ein sehr guter Pfad.

Mehr Details stehen in docs/local-ai-options.md.

Bestehende Tools Einbinden

DailyStruggleOS ersetzt nicht automatisch Obsidian, Notion, Apple Notes, Google Drive, Outlook, Gmail oder lokale Ordner. Der Agent soll beim Onboarding fragen, was du schon nutzt, und dann eine schlanke Integration vorschlagen: verlinken, exportieren, importieren, zusammenfassen oder nur einen Index bauen. Kein Toolwechsel als Selbstzweck.

Language And Adaptation

Agents must respond in the user's language from the first turn. If the user writes in English, the agent should translate/adapt onboarding questions, summaries and generated local notes immediately. German starter text is not a requirement for the user.

Stable filenames, metadata keys and template fields may stay simple ASCII where that helps portability. Private content still belongs only in ignored local user files.

Privacy-Grundsatz

DailyStruggleOS ist local-first und private by default. Deine echten Inhalte gehören in deinen lokalen Ordner. Sie sollten nicht versehentlich in Git landen.

Dieses Starter Kit bringt deshalb eine strenge .gitignore mit. Sie schützt typische Nutzerbereiche wie Inbox, Projekte, Finance, Dokumente, Reviews, Exports, Secrets und lokale Caches. Vor einem Public Push solltest du trotzdem die Checkliste in docs/github-release-checklist.md laufen lassen.

License, Disclaimer And Brand

DailyStruggleOS Starter Kit uses the MIT License for its code, scripts, docs, templates and examples. See LICENSE.

DailyStruggleOS is an organization and template system, not legal, medical, financial, tax, mental-health or other professional advice. See DISCLAIMER.md.

DailyStruggleOS passed a preliminary name/domain knockout check for an initial open-source starter-kit release. It is not a registered trademark and the MIT License does not settle naming or trademark rights. See TRADEMARK.md.

Design-Prinzipien

• Weniger Struktur, mehr Klarheit.
• Dateien statt Lock-in.
• Erst sortieren, dann optimieren.
• Fragen nur, wenn sie den nächsten Schritt leichter machen.
• Private Daten bleiben lokal.
• Externe Aktionen brauchen exakte Specs.
• Reviews sollen entlasten, nicht bewerten.

Release Notes

For brand status and release readiness, see TRADEMARK.md, LICENSE_DECISION.md and docs/release-readiness-review.md.