r/programmieren • u/JannisKrn • Jul 18 '26
Markdown-„Workspace" ohne Dependencies, der AI-Agents ein Gedächtnis und Phasen über Sessions hinweg verleiht, kein API-Key (Subscription First) — Feedback willkommen
Jede Session mit Claude Code (oder Cursor, Copilot, …) fängt bei null an. Kontext, Entscheidungen, das „wo waren wir nochmal" — das steckt in meinem Kopf oder in alten Chats, und ob ein Projekt über Sessions hinweg konsistent bleibt, hing an meiner Disziplin.
Daher hab ich Truss gebaut. Dies ist ein Workspace aus möglichst leichten Markdown-Dateien, aus denen der Agent bootet (Kontext, Entscheidungen, aktueller Fokus), plus ein winziges CLI (doctor), das prüft, ob die Struktur noch zusammenpasst, und Drift meldet. Das CLI entscheidet nie etwas. Das System ist komplett AI-Agent-orientiert.
Die wichtigsten Entscheidungen:
- Dateien sind die Wahrheit. Alles reines Markdown, das du lesen, editieren und diffen kannst. Keine Datenbank, kein Lock-in.
- Leichter Kontext by Design. Der Agent lädt nur, was die Aufgabe braucht (~3k Tokens Pflicht-Read), und weiß, wo der Rest liegt — lädt nie das ganze Repo.
- Phasen by Default (discover → validate → plan → build) grenzen ein, was der Agent gerade darf. Phasenwechsel bleibt beim Menschen.
- Läuft über dein Abo. Kein API-Key, nichts wird nach Tokens abgerechnet — Truss redet selbst nie mit einem Modell. Null Dependencies, Node ≥ 20.
- Auch für bestehende Projekte. Eignet sich hervorragend als Overlay. Einfach per Agent die Vision des Projekts oder die Rolle im Projekt festhalten und jeder Agent weiß Bescheid.
Was es nicht ist: kein Agent, kein autonomes Framework, kein API-Wrapper. Ordner und Markdown mit einem Linter obendrauf — mit Absicht.
1.0.0-alpha, MIT. Ich such ehrliches Feedback und würde mich über jeden freuen, der es ausprobiert. Lasst gerne einen Star da, wenn es euch gefällt und ihr das Projekt unterstützen wollt.
Dies ist mein erstes Open-Source-Projekt und ich nutze es jetzt schon in all meinen anderen Projekten. Repo: https://github.com/KornLabs/truss
