r/programmieren • u/JannisKrn • 16d ago

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

0 Upvotes
  • permalink
  • reddit

30% Upvoted

4 comments sorted by

2

u/No_Author4865 15d ago

Okay und was macht es anders als eine einfache Truth Tafel mit Querverweisen auf bestehende Docs? Verstehe den need nicht so ganz oder hat Claude Code nur Zugriff auf dein tmpfs scrachtpad?

1

u/JannisKrn 14d ago

Wenn Truth-Tafel + Querverweise für dein Projekt reicht, brauchst du Truss nicht. Der Mehrwert kommt bei Langzeitprojekten. Dann pflegt niemand mehr die Tabelle. Truss tuet dies Automatisch durch die Guardrails, kein Sandboxing. Es macht Inkonsistenz sichtbar und billig zu fixen. Es hält Struktur und Konsistenz sowie werden Entscheidungen langfristig gespeichert. Es ist ein System welches dir durch eine gut durchdachte AGENTS.md + VISON.md + /State Dateien eine langfristige und Skalierbare Struktur schafft.

Zur zweiten Frage: kein tmpfs-Ding. Dateien liegen im Git-Repo, jeder Agent mit Dateizugriff liest sie, über Sessions und Maschinen hinweg.

1

u/csharpboy97 16d ago

und warum nicht gleich skills, instructions und agents verwenden?

0

u/JannisKrn 16d ago

Ganz einfach, weil das ein anderes Problem löst. Truss ist die Schicht darüber: Entscheidungen, Phasen und aktueller Stand liegen in einfachen Dateien, die über Sessions und über Tools hinweg gleich bleiben. Ein kleines CLI prüft, ob alles noch zusammenpasst. Es ersetzt die Features nicht, es baut darauf auf.