Persistent context for your AI coding agentBleibender Kontext für deinen KI-Coding-Agenten

Stop re-explaining your project to your AI agent. It already knows your repos.

Erklär deinem KI-Agenten nicht jedes Mal alles neu. Er kennt deine Repos schon.

Your repos, clients, conventions, last week's decisions. Your coding agent reads them at the start of every session, so context compounds instead of resetting. Just plain markdown and YAML in git, any model or frontend.Deine Repos, Kunden, Konventionen, die Entscheidungen von letzter Woche. Dein Coding-Agent liest sie zu Beginn jeder Session wieder ein, damit Kontext wächst, statt sich zurückzusetzen. Nur Plain-Markdown und YAML in Git, egal welches Modell oder Frontend.

Public·MIT·clone & read it yourself·runs our company daily Public·MIT·selbst klonen & lesen·betreibt täglich unsere Firma

Try it in 2 minutesIn 2 Minuten ausprobieren
examples/agency · shipped demo workspacemitgelieferter Demo-Workspace
> good morning Morning. You're mid-incident on bigcorp: Stripe webhook retries are failing in prod (P1, opened yesterday). Root cause traced to the webhook secret; next step is the retry fix. startupxyz onboarding: email-verification wired, 6 tests green. Board: 2 doing · 1 review · cart-a11y waits on PR #214.
> guten morgen Morgen. Auf bigcorp läuft ein P1: Stripe-Webhook-Retries schlagen in prod fehl. Root Cause gestern gefunden (Webhook-Secret); nächster Schritt ist der Retry-Fix. startupxyz-Onboarding: E-Mail-Verifikation steht, 6 Tests grün. Board: 2 doing · 1 review · cart-a11y wartet auf PR #214.

This is the shipped demo workspace answering. Run it yourself in 2 minutes. Das ist der mitgelieferte Demo-Workspace. Führ ihn in 2 Minuten selbst aus.

The shipped demo workspace drawn as a containment ring: 27 files in six folders around a centre, with one dot in the outer band for each of their 1162 lines, so a folder that holds more shows denser. identity holds who you are and who you send to, workflow holds what happens when, infra holds where things run, work holds the task board and the log, protocols holds the standing orders, and .claude holds the agents. At session start the agent reads only what it needs before its first answer and opens the rest when the work names it (the figure in the concept section shows what is read when), then writes one line back into work/log.md. Clone examples/agency and the same tree is on your disk. Der mitgelieferte Demo-Workspace als Ring gezeichnet: 27 Dateien in sechs Ordnern um eine Mitte, im Außenband ein Punkt je Zeile ihrer 1162 Zeilen, ein Ordner mit mehr Inhalt ist also dichter. identity hält, wer du bist und an wen du sendest, workflow, was wann passiert, infra, wo was läuft, work das Aufgabenbrett und das Protokoll, protocols die Standing Orders und .claude die Agenten. Zum Session-Start liest der Agent nur, was er vor der ersten Antwort braucht, und öffnet den Rest, wenn die Arbeit ihn nennt (das Bild im Konzept-Abschnitt zeigt, was wann gelesen wird), danach schreibt er eine Zeile zurück in work/log.md. Klone examples/agency, dann liegt derselbe Baum auf deiner Platte.

examples/agency: 27 files, 1162 lines, one dot each. examples/agency: 27 Dateien, 1162 Zeilen, je Zeile ein Punkt. Look inside it → Reinschauen →

▶ See it work (90 sec)·Read the code on GitHub·Newly public, hit a rough edge? Tell us. ▶ Sieh es arbeiten (90 Sek.)·Lies den Code auf GitHub·Frisch öffentlich, irgendwo hakt es? Sag's uns.

The cold-start problemDas Kaltstart-Problem

Every session starts from scratch.Jede Session beginnt bei null.

Re-explain your conventions to the agent, again.Dem Agenten deine Konventionen wieder neu erklären.
Load the wrong client's context and only notice halfway through.Den falschen Kunden-Kontext laden und es erst auf halbem Weg merken.
No record of what you decided last week.Kein Protokoll dessen, was du letzte Woche entschieden hast.

Most AI work todayKI-Arbeit heute

A bare My-Documents folder: everyone piling up their own chaos, every conversation rebuilding context and structure from scratch.Ein nackter My-Documents-Ordner. Jeder häuft sein eigenes Chaos an, jede Unterhaltung baut Kontext und Struktur von Grund auf neu.

With BKS open-bridgeMit BKS open-bridge

A clear, separated layout the agent files into (shipped as example structures, not reinvented by every user).Ein klares, getrenntes Layout, in das der Agent ablegt. Als Beispielstrukturen mitgeliefert, nicht von jedem Nutzer neu erfunden.

The substrate, shownDas Substrat, gezeigt

Plain text in git. Clone it and look.Plain Text in Git: Klone es und schau rein.

No adjectives. examples/agency/ is a real, complete config you can clone today; the STATUS and work log below are the shape your own work/ takes once you start logging.Keine Adjektive. examples/agency/ ist eine echte, vollständige Config, die du heute klonen kannst; der STATUS und das Arbeitslog unten sind die Form, die dein eigenes work/ annimmt, sobald du anfängst zu loggen.

examples/agency/2 separated clients2 getrennte Kunden
examples/agency/ ├── ecosystem.yaml # repo + client registry ├── bridge-config.yaml ├── identity/ │ ├── accounts/ # cloud/mail inventory │ └── mandants/ # recipient groups ├── workflow/ │ ├── calendars/ │ └── contexts/webapp/ # per-engagement world ├── infra/ │ ├── channels/ remotes/ backups/ └── .claude/agents/ # ops-officer, code-analyst …
work/tasks/bigcorp-migration/STATUS.mdverbatim from the READMEwortgetreu aus dem README
+# STATUS: bigcorp-migration
+status: doing
+context: bigcorp
+last: Migrated the invoice pipeline to the new schema; one test still red.
+next: Fix the failing UBL-validation case, then open the PR.
work/log.md$ cat work/log.md
## Fri 20.06
| 14:22 | Decision | bigcorp | Pinned the schema to v2: v3 breaks the old exports. |

That row is in the repo six months from now, in a diff, readable by any agent. (Copied character-for-character from the README.)Diese Zeile steht in sechs Monaten noch im Repo, in einem Diff, lesbar von jedem Agenten. (Zeichengenau aus dem README.)

What you write today, it reads in six months.

Was du heute schreibst, liest es in sechs Monaten.

Agents can cat a file, but they can't hold an API key. Because the whole thing is plain text in git, there is no migration, no second app, no proprietary store your data has to outlive; it is inspectable, diff-able, and yours. The constellation on the Explore page is this same knowledge base as a graph; the STATUS and log to the left are one real row of it.Agenten können eine Datei catten, aber keinen API-Key halten. Weil das Ganze Plain Text in Git ist, gibt es keine Migration, keine zweite App, keinen proprietären Speicher, den deine Daten überleben müssten; es ist einsehbar, diff-bar und deins. Die Konstellation auf der Explore-Seite ist genau diese Wissensbasis als Graph; der STATUS und das Log links sind eine echte Zeile davon.

no databasekeine Datenbank no SaaSkein SaaS no daemonkein Daemon

BKS open-bridge's pieces form one connected web. Click through them on the interactive map, or read the plain-language guide.Die Bausteine von BKS open-bridge bilden ein verbundenes Netz. Sieh jeden einzelnen auf einer interaktiven Karte zum Klicken, oder lies den Leitfaden in einfacher Sprache.

How it worksSo funktioniert es

At session start the agent reads the substrate, and the record compounds. Bei Session-Start liest der Agent das Substrat, und das Protokoll wächst.

Plain text in git. The agent reads it before answering, then writes back what happened. Day two starts where day one ended. Plain Text in Git. Der Agent liest es, bevor er antwortet, und schreibt zurück, was passiert ist. So beginnt Tag zwei dort, wo Tag eins aufhörte.

Session start · readSession-Start · gelesen
CLAUDE.md2.1 KB
ecosystem.yaml1.4 KB
work/board.md0.8 KB
work/log.md3.6 KB
STATUS.md
status: doing
context: bigcorp
owner: ops-officer
work/log.md · written backwork/log.md · zurückgeschrieben
| 09:14 | Decision bigcorp | scoped the inbound pipeline
| 11:02 | Fix startupxyz | retry on 429, backoff added
| 14:22 | Decision bigcorp | Pinned the schema to v2: v3 breaks the old exports.
work/board.mdwork/board.md
backlog1
webhook auth
doing1
inbound pipe
review1
retry/backoff
done1
env bootstrap

Two sessions, run for run. Without a written record a session re-reads the same four files on every run and finishes where it started. With one, it reads them once, writes what happened to work/log.md, and from the second run onward starts from that record instead. After three runs the second session has a stack of three entries and the first still has none. Zwei Sitzungen, Lauf für Lauf. Ohne Protokoll liest eine Sitzung bei jedem Lauf dieselben vier Dateien neu und endet dort, wo sie angefangen hat. Mit Protokoll liest sie sie einmal, schreibt fest was passiert ist, und startet ab dem zweiten Lauf aus diesem Protokoll. Nach drei Läufen hat die zweite Sitzung einen Stapel von drei Einträgen, die erste keinen.

The same three runs, two sessions. Only one of them keeps anything. Dieselben drei Läufe, zwei Sitzungen. Nur eine behält etwas.

What your agent gainsWas dein Agent gewinnt

Two things this gives your agent: more context, less chaos.Zwei Dinge, die das deinem Agenten gibt: mehr Kontext, weniger Chaos.

Both were coined by the team at BKS-Lab. The plain meaning leads, the name follows.Beide wurden im Team bei BKS-Lab geprägt. Die schlichte Bedeutung führt, der Name folgt.

Context BoosterContext Booster

An independent "third side" beside your model and your tool, coined "Context Booster" at BKS-Lab.Eine modell- und frontend-unabhängige „dritte Seite" (bei BKS-Lab als „Context Booster" geprägt).

You work with whatever model and whatever frontend you like. BKS open-bridge layers in persistent context about your world (your repos and clients, your machines, what you worked on yesterday), so the agent stops loading the wrong client. The boost comes from a layer beside both. It doesn't care what you run, because the substrate is plain text every runtime can read.Du arbeitest mit dem Modell und dem Frontend, das du willst. BKS open-bridge legt persistenten Kontext über deine Welt darüber: deine Repos und Kunden, deine Maschinen, woran du gestern gearbeitet hast. Damit hört der Agent auf, den falschen Kunden zu laden. Der Boost kommt von einer dritten Seite, der egal ist, was du nutzt. Denn das Substrat ist Plain Text, den jede Runtime lesen kann.

Chaos TamerChaos Tamer

Structuring unstructured AI dialogues, coined at BKS-Lab.„Strukturierung unstrukturierter KI-Dialoge", bei BKS-Lab geprägt.

It ships ready-made structure you don't have to invent: a board, a log, and per-task status (backlog → doing → review → done over tasks/ and streams/). Decisions, findings and status get filed in plain text as you work. Unstructured sessions become a persistent, compounding record instead of another My-Documents pile.Es liefert fertige Struktur mit, die du nicht erfinden musst: ein Board, ein Log und Per-Task-Status (backlog → doing → review → done über tasks/ und streams/). Entscheidungen, Erkenntnisse und Status werden als Plain Text abgelegt, während du arbeitest: Aus unstrukturierten Sessions wird ein persistentes, wachsendes Protokoll statt des nächsten My-Documents-Haufens.

Bet / Roadmap Workspace separation as the default is the intended stance: agreed in principle, not yet built (labelled honestly below). Workspace-Trennung als Default ist die beabsichtigte Haltung. Im Prinzip vereinbart, noch nicht gebaut (unten ehrlich gekennzeichnet).

A day with itEin Tag damit

Say it plainly. Get the work, already in context.Sag es schlicht: Hol dir die Arbeit, schon im Kontext.

good morning, briefingguten Morgen, Briefing

Get today's board, the day's git activity and what's gone stale. The agent already knows which repos and which client you're on.Hol dir das heutige Board, die Git-Aktivität des Tages und was liegen geblieben ist. Es weiß dabei schon, welche Repos und welcher Kunde dran sind.

where was I on the bigcorp migration?wo war ich bei der bigcorp-Migration?

Get the task's exact state read back ("last: migrated the invoice pipeline, one test still red. next: fix the failing case, then open the PR"), so you resume mid-thought.Lass dir den genauen Stand der Aufgabe zurücklesen („zuletzt: Invoice-Pipeline migriert, ein Test noch rot. als Nächstes: den fehlschlagenden Fall fixen, dann den PR öffnen") und steig mitten im Gedanken wieder ein.

switch to startupxyzwechsle zu startupxyz

Get that client's repos, conventions and open tasks loaded from its own workspace; the agent works from startupxyz's facts, not bigcorp's.Hol dir die Repos, Konventionen und offenen Aufgaben dieses Kunden aus seinem eigenen Workspace. Der Agent arbeitet mit den Fakten von startupxyz, nicht denen von bigcorp.

why did we pin the schema to v2?warum haben wir das Schema auf v2 gepinnt?

Get the answer pulled from a dated log row you wrote back then ("v3 breaks the old exports"), still in the repo, in plain text, months on.Hol dir die Antwort aus einer datierten Log-Zeile, die du damals geschrieben hast: „v3 bricht die alten Exporte", Monate später noch im Repo, als Plain Text.

draft a status mail to the bigcorp leadentwirf eine Status-Mail an den bigcorp-Lead

Get a ready message in your voice, with your signature, the facts pulled from the task. You read it and send; the agent never sends for you.Hol dir eine fertige Nachricht in deiner Stimme und mit deiner Signatur, die Fakten aus der Aufgabe gezogen. Du liest sie und sendest; der Agent sendet nie für dich.

/archive/archive

Get the week's log rolled into a dated summary and a fresh log started: a paper trail that compounds week over week instead of evaporating.Lass dir das Wochen-Log zu einer datierten Zusammenfassung verdichten und ein frisches Log starten (eine Spur, die Woche für Woche wächst, statt zu verdampfen).

Say it once. Six months later the decision is still there, and so is the reason for it.

Sag es einmal. Sechs Monate später steht die Entscheidung noch da, und der Grund dafür auch.

Jobs, not featuresAufgaben, keine Features

What people run on it.Was darauf läuft.

Org-aware without forkingOrg-bewusst ohne Fork

One /overlay add <git-url> gives every teammate your org's skills and configs on a vanilla clone, no per-person fork to maintain.Ein /overlay add <git-url> gibt jedem im Team die Org-Skills und -Configs auf einem unveränderten Clone (kein Fork pro Person).

Client status updatesKunden-Status-Updates

Turn a board item into a styled status email to the right recipient group. The sender is always you, nothing sends itself.Mach aus einem Board-Item eine gestylte Status-Mail an die richtige Empfängergruppe: Absender bist immer du, nichts sendet sich selbst.

Meeting → protocol → tasksMeeting → Protokoll → Tasks

Meeting notes become classified insights and board-mapped tasks you approve: decisions stop evaporating after the call.Meeting-Notizen werden zu klassifizierten Erkenntnissen und board-zugeordneten Tasks, die du freigibst. Entscheidungen verdampfen nach dem Call nicht mehr.

Document intake & filingDokumenten-Intake & Ablage

Point it at inboxes and flagged mail. Every document gets renamed, tagged and filed by your routing rules, and never deleted.Richte es auf Inboxen und geflaggte Mails. Jedes Dokument wird umbenannt, getaggt und nach deinen Routing-Regeln abgelegt, und nie gelöscht.

Multi-instance data isolationMulti-Instanz-Datentrennung

One bridge per client or org: separate clones, some strictly local-only, indexed in a registry so data never cross-contaminates.Eine Bridge pro Kunde oder Organisation, also getrennte Clones (manche strikt lokal), in einer Registry indiziert, damit sich Daten nie vermischen.

Knowledge that grows itselfWissen, das sich selbst aufbaut

File-based memory plus a learning loop. Postmortems propose improvements, a curator consolidates patterns, the system compounds.Dateibasiertes Gedächtnis plus Lernschleife: Postmortems schlagen Verbesserungen vor, ein Kurator konsolidiert Muster, das System wächst.

Cross-tool skills, private by defaultTool-übergreifende Skills, privat per Default

One skills tree serves Claude Code, Copilot CLI, Codex, Cursor and Gemini, with scope-routing keeping private content local while CORE flows upstream.Ein Skills-Baum bedient Claude Code, Copilot CLI, Codex, Cursor und Gemini; Scope-Routing hält Privates lokal, während CORE upstream fließt.

All eight jobs, with the primitives behind each →Alle acht Aufgaben, mit den Primitiven dahinter →

What else it can doWas es noch kann

The four core pieces stand on their own. The rest is optional.Schon die vier Kernteile bringen dir etwas. Der Rest ist optional.

The four core pieces (context registry, task management, skills & commands, standing orders) run from a fresh clone; they're what powered the day above. Everything below is optional, USER-scope, off until you turn it on.Die vier Kernteile: Kontext-Registry, Task-Management, Skills & Befehle, Standing Orders. Sie laufen direkt aus einem frischen Clone heraus (du hast sie oben im Tagesablauf gesehen). Alles darunter ist optional, USER-scope, und bleibt aus, bis du es einschaltest.

Optional: turn on when you want itOptional: einschalten, wenn du es brauchst 9
ChannelsChannelsdocs →

Declare email, Telegram, Signal or iMessage once; the agent drafts, you send.E-Mail, Telegram, Signal oder iMessage einmal deklarieren; der Agent entwirft, du sendest.

RemotesRemotesdocs →

One source of truth for your machines. Wake, ssh, check, deploy, Tailscale-first.Eine Wahrheitsquelle für deine Maschinen: wecken, ssh, prüfen, deployen, Tailscale zuerst.

Document filingDokumente ablegendocs →

Point it at an inbox; it names, files and logs each doc, and never deletes.Richte es auf einen Posteingang; es benennt, legt ab und protokolliert jedes Dokument, löscht aber nichts.

PersonasPersonasdocs →

The identities you hold (signatures, tax data, filing paths), so things land in the right place.Die Identitäten, die du hast (Signaturen, Steuerdaten, Ablagepfade), damit alles am richtigen Ort landet.

Sub-agentsSub-Agentendocs →

Offload heavy or parallel work; it returns a clean summary. Native on Claude Code; inline elsewhere.Schwere oder parallele Arbeit auslagern; es liefert eine saubere Zusammenfassung. Nativ in Claude Code; anderswo läuft es inline.

Tracker syncTracker-Syncdocs →

Read work items from GitHub Projects; the agent keeps your board and tasks aligned. Gated, never auto.Work-Items aus GitHub Projects lesen; der Agent hält Board und Tasks abgeglichen, immer mit Freigabe, nie automatisch.

WorkspacesWorkspacesdocs →

A named binding of member repos and config overlays, cloned into a public-fork-safe path and indexed in a shared machine-global registry.Eine benannte Bindung aus Mitgliedsrepos und Config-Overlays, geklont in einen für öffentliche Forks sicheren Pfad und in einer geteilten maschinenweiten Registry indiziert.

WorkloadsWorkloadsdocs →

One declared run on one machine, in one file: report, poller, daemon, watcher or agent. Provisioned from the declaration and reconciled against the live service manager, never against a status field.Ein deklarierter Lauf auf einer Maschine, in einer Datei: Bericht, Poller, Daemon, Wächter oder Agent. Aus der Deklaration eingerichtet und gegen den lebenden Dienstverwalter abgeglichen, nie gegen ein Statusfeld.

AgentsAgentsdocs →

Bridge-Agents are persistent, addressable A2A endpoints that front one persona to the outside world; the MCP→A2A gateway makes them reachable from MCP-only frontends too, always under a human gate.Bridge-Agents sind persistente, adressierbare A2A-Endpunkte, die eine Persona nach außen vertreten; das MCP→A2A-Gateway macht sie auch aus reinen MCP-Frontends erreichbar. Das läuft immer unter menschlicher Freigabe.

And the full layout (every path, the CORE/USER split, the rest) is in the docs →Und das ganze Layout (jeder Pfad, der CORE/USER-Split, der Rest) steht in den Docs →

Everything here ships and runs today. Roadmap items (workspace separation as the default, and more) live in the honesty board below, labelled as bets, not features.Alles hier wird mitgeliefert und läuft heute. Roadmap-Punkte wie die Workspace-Trennung als Default stehen unten im Status-Board, als Wetten gekennzeichnet, nicht als Features.

The honest objectionDer ehrliche Einwand

Why not just a CLAUDE.md and a folder of my own?Warum nicht einfach eine CLAUDE.md und ein eigener Ordner?

A dotfile of instructionsEin Dotfile mit Anweisungen

  • One flat instruction sheet, re-read each session.Ein flaches Anweisungsblatt, jede Session neu gelesen.
  • No persistent record of what happened last week.Kein persistentes Protokoll dessen, was letzte Woche passierte.
  • One context bleeds into another; you separate it by hand.Ein Kontext sickert in den nächsten durch; du trennst von Hand.
  • You invent the structure yourself, from a blank folder.Du erfindest die Struktur selbst, aus einem leeren Ordner.

A structured workspaceEin strukturierter Workspace

  • +Separate per-context worlds: identity, workflow, work.Getrennte Kontext-Welten (identity, workflow, work).
  • +A work log + task board that survive across sessions.Ein Arbeitslog + Task-Board, die über Sessions hinweg bestehen.
  • +Shipped example structures, relief instead of a blank page.Mitgelieferte Beispielstrukturen: Entlastung, kein leeres Blatt.
  • +A CORE/USER split, where shared templates update without ever clobbering your private data.Ein CORE/USER-Split. Geteilte Templates aktualisieren sich, ohne je deine privaten Daten zu überschreiben.

Not for a single-repo project or ad-hoc one-off scripting. The coordination layer is overhead you won't use.Nicht für ein Single-Repo-Projekt oder Ad-hoc-Einmal-Scripting. Die Koordinationsschicht ist dort Overhead, den du nicht brauchst.

The evidence boundaryDie Beweis-Grenze

What's proven, what's a bet, what's open.Was bewiesen ist, was eine Wette ist, was offen ist.

BKS open-bridge runs the company that builds it; every feature exists because we needed it on a real workday. You're early: it's newly public, no external users yet. The ledger below says exactly what that means.BKS open-bridge betreibt die Firma, die es baut. Jedes Feature existiert, weil wir es an einem echten Arbeitstag gebraucht haben. Du bist früh dran: frisch öffentlich, noch ohne externe Nutzer. Was genau das heißt, steht ehrlich im Status-Board.

Provenbuilt · self-used N=2gebaut · selbst genutzt N=2
  • The three-cluster layout (identity / infra / workflow), the Task-Management system (board, log, per-task STATUS), the CORE/USER branch split, personas, standing orders, and the skills layer all run from a fresh clone today.Das Drei-Cluster-Layout (identity / infra / workflow), das Task-Management (Board, Log, Per-Task-STATUS), der CORE/USER-Branch-Split, Personas, Standing Orders und die Skills-Schicht laufen heute direkt aus einem frischen Clone heraus.
  • Scope-routing works in practice: each file carries a scope (core / org / user); /promote routes per scope. Demonstrated, not theoretical.Scope-Routing funktioniert in der Praxis: jede Datei trägt einen Scope (core / org / user); /promote routet pro Scope (demonstriert, nicht theoretisch).
  • GitHub task sync works for our own use: the agent already knows whether a task also exists in GitHub and syncs it. Jira is untested.GitHub-Task-Sync funktioniert für unseren Eigengebrauch. Der Agent weiß bereits, ob ein Task auch in GitHub existiert, und syncht ihn. Jira ist ungetestet.
Betfalsifiable wagersfalsifizierbare Wetten
  • Markdown + YAML + git is the substrate each new generation of agent runtimes keeps reading natively, because models read text, not a vendor API. Falsified if the dominant stack forces a vendor schema (Notion-MCP / Linear-MCP) as the standard.Markdown + YAML + Git ist das Substrat, das jede neue Generation von Agenten-Runtimes nativ weiterliest, weil Modelle Text lesen, keine Vendor-API. Falsifiziert, wenn der dominante Stack ein Vendor-Schema (Notion-MCP / Linear-MCP) als Standard erzwingt.
  • A lean, opinionated, MIT-OSS method beats a vendor workflow-builder for users who want to switch models freely. Falsified if Cursor/Anthropic ship a first-class markdown-in-git mode.Eine schlanke, meinungsstarke MIT-OSS-Methode schlägt einen Vendor-Workflow-Builder für Nutzer, die Modelle frei wechseln wollen. Falsifiziert, wenn Cursor/Anthropic einen erstklassigen Markdown-in-Git-Modus liefern.
  • Workspace separation as a hard default, once built, is the right call for most users, not an opt-in switch (the default itself is still on the roadmap; see Open).Workspace-Trennung als harter Default ist, sobald gebaut, für die meisten Nutzer die richtige Wahl, kein Opt-in-Schalter (der Default selbst steht noch auf der Roadmap; siehe Open).
Openunsolvedungelöst
  • Zero external users today: newly public, not yet adopted. Until real users arrive, every statement about a target audience is a hypothesis, not a market test.Heute null externe Nutzer: frisch öffentlich, noch nicht verbreitet. Bis echte Nutzer kommen, ist jede Aussage über eine Zielgruppe eine Hypothese, kein Markttest.
  • Workspace-separation-as-default and the "ask if unplaceable" rule are not yet built into BKS open-bridge; the hard-silo vs soft-folder default is unresolved.Workspace-Trennung-als-Default und die „frage, wenn unzuordenbar"-Regel sind noch nicht in BKS open-bridge eingebaut; harter Silo vs. weicher Ordner ist ungeklärt.
  • First-session value is thin: a fresh clone gives little reward until work/log.md is filled.Der Erst-Session-Wert ist dünn: ein frischer Clone gibt wenig zurück, bis work/log.md gefüllt ist.
  • Terminology cleanup is pending (work-task → Task-Management; the work/ folder made unambiguous).Begriffs-Bereinigung steht aus (work-task → Task-Management; der work/-Ordner eindeutig gemacht).

If this resonates: star the repo and upvote the ROADMAP issues you want most. That's literally the signal priorities are decided by.Wenn dich das anspricht: Stern aufs Repo und stimm für die ROADMAP-Issues, die du am dringendsten willst. Genau daraus entsteht die Priorisierung.

The concept, in briefDas Konzept, kurz

A bridge. And you can run many, safely.Eine Bridge. Und du kannst viele betreiben, sicher.

A bridge is your agent's memory of your world, plain markdown and YAML in git it reads at session start. You can run many: one per client or context, all on one shared CORE (one foundation, separate private rooms). It compounds safely because your data and the shipped templates live on different paths.Eine Bridge ist das Gedächtnis deines Agenten für deine Welt, gespeichert als Plain-Markdown und YAML in Git, das er zum Session-Start liest. Du kannst viele betreiben: eine pro Kunde oder Kontext, alle auf einem gemeinsamen CORE (ein Fundament, getrennte private Räume). Es wächst sicher, weil deine Daten und die mitgelieferten Templates auf verschiedenen Pfaden liegen.

Improvements go upstream with /promote. And it's runtime-agnostic: one skills/ tree symlinks into each tool. Tested on Claude Code, working via AGENTS.md elsewhere, honestly labelled.Verbesserungen gehen mit /promote nach upstream. Und es ist runtime-unabhängig: ein skills/-Baum wird per Symlink in jedes Tool eingebunden. Getestet auf Claude Code, anderswo via AGENTS.md, ehrlich gekennzeichnet.

What a session reads, and when

Was eine Sitzung liest, und wann

Drawn from docs/data-model.yaml, like the tables in docs/data-model.mdAus docs/data-model.yaml gezeichnet, wie die Tabellen in docs/data-model.md

Before you clone itBevor du es klonst

The six questions people actually ask.Die sechs Fragen, die wirklich kommen.

Does it work outside Claude Code?Läuft es außerhalb von Claude Code?

One skills/ tree symlinks into each tool. It is tested on Claude Code and works elsewhere through AGENTS.md, which Codex, Cursor, Copilot CLI and Gemini read natively. Sub-agents are the one Claude Code specific piece; everywhere else that logic runs inline.Ein skills/-Baum wird per Symlink in jedes Tool eingebunden. Getestet ist es auf Claude Code, anderswo läuft es über AGENTS.md, das Codex, Cursor, Copilot CLI und Gemini nativ lesen. Sub-Agenten sind das einzige Claude-Code-spezifische Stück, überall sonst läuft dieselbe Logik inline.

What happens to my files when CORE updates?Was passiert mit meinen Dateien, wenn CORE sich aktualisiert?

Nothing. Your files and the shipped templates sit on paths that never overlap, so the two merge without conflict by construction. Your config, your work/ directory and every instance file live on your own branch; the templates live on the default branch.Nichts. Deine Dateien und die mitgelieferten Templates liegen auf Pfaden, die sich nie überschneiden, also mergen die beiden konfliktfrei, schon vom Aufbau her. Deine Config, dein work/-Verzeichnis und jede Instanzdatei leben auf deinem eigenen Branch, die Templates auf dem Default-Branch.

What does it cost?Was kostet es?

The repo is MIT and there is nothing to host, no account and no waitlist. What you do pay for is the coding agent you already run: this is a layer of plain files beside it, not a replacement for it.Das Repo ist MIT, es gibt nichts zu hosten, kein Konto und keine Warteliste. Was du zahlst, ist der Coding-Agent, den du ohnehin fährst: das hier ist eine Schicht aus Plain-Text daneben, kein Ersatz dafür.

How does a public repo keep my work private?Wie hält ein öffentliches Repo meine Arbeit privat?

Your copy has a private origin from the first command, and the public repo is only a read-only upstream. A push guard refuses to send a user branch anywhere public, and the same split is drawn in the diagram above: scope:core travels upstream, scope:user stops at the edge.Deine Kopie hat vom ersten Befehl an ein privates Origin, und das öffentliche Repo ist nur ein Upstream zum Lesen. Ein Push-Guard weigert sich, einen User-Branch irgendwohin öffentlich zu schicken, und dieselbe Trennung ist oben gezeichnet: scope:core geht nach upstream, scope:user bleibt an der Kante stehen.

How many bridges can I run?Wie viele Bridges kann ich betreiben?

As many as you have worlds to keep apart, typically one per client or context. They share one CORE and keep separate private rooms, so data from one never bleeds into another.So viele, wie du Welten auseinanderhalten musst, üblicherweise eine pro Kunde oder Kontext. Sie teilen sich ein CORE und behalten getrennte private Räume, damit Daten der einen nie in die andere laufen.

How early is this, really?Wie früh ist das wirklich?

Early. It is newly public with no external users yet, and it runs the company that builds it every working day. That is the honest pair: proven in daily use by three people, unproven by anyone else. The status board above labels each piece as shipped, a bet, or open.Früh. Es ist frisch öffentlich, bisher ohne externe Nutzer, und es betreibt die Firma, die es baut, an jedem Arbeitstag. Das ist das ehrliche Paar: im täglichen Gebrauch von drei Leuten bewährt, von sonst niemandem. Die Statustafel oben kennzeichnet jedes Stück als ausgeliefert, als Wette oder als offen.

Get startedLoslegen

Try it now, or adopt it properly.Jetzt ausprobieren. Oder richtig übernehmen.

Try: 2 minutes, throwawayAusprobieren (2 Minuten, wegwerfbar)

The shipped demo workspace: two clients, a filled board, two days of log, a P1 mid-flight. Don't push. This clone points at the public repo.Der mitgelieferte Demo-Workspace: zwei Kunden, ein gefülltes Board, zwei Tage Log, ein P1 mittendrin. Nicht pushen: Dieser Clone zeigt aufs öffentliche Repo.

git clone https://github.com/bks-lab/open-bridge.git cd open-bridge/examples/agency claude # or: codex, copilot

Needs an agent CLI on your machine, e.g. npm install -g @anthropic-ai/claude-code.Braucht eine Agent-CLI auf deinem Rechner (z. B. npm install -g @anthropic-ai/claude-code).

Then ask:Dann frag: good morning · where was I on the payment retry? · why is the cart task in review?

Everything it answers is read from plain markdown sitting in that folder. Open work/log.md next to it and watch the trick disappear. That's the product.Alles, was es antwortet, liest es aus purem Markdown in diesem Ordner; öffne daneben work/log.md und sieh zu, wie der Trick verschwindet. Genau das ist das Produkt.

Adopt: private origin firstÜbernehmen (erst ein privates Origin)

This is a public repo, so step 1 gives your data a private home: clone it, then re-home the remotes at once. Your repo becomes origin; BKS open-bridge stays a read-only upstream, so a stray push can't publish your branch.Das ist ein öffentliches Repo, darum gibt Schritt 1 deinen Daten ein privates Zuhause: klonen, dann sofort die Remotes umziehen. Dein Repo wird origin; BKS open-bridge bleibt ein read-only upstream, damit ein versehentlicher Push deinen Branch nicht veröffentlichen kann.

# 1. Clone, then re-home the remotes at once: open-bridge becomes a read-only # upstream, your own private repo becomes origin. git clone https://github.com/bks-lab/open-bridge.git my-bridge cd my-bridge git remote rename origin upstream gh repo create <you>/my-bridge --private --source=. --remote=origin --push # 2. Let the push guard classify your new origin offline: printf 'repo: <you>/my-bridge\nis_public: false\n' > .bridge-origin # 3. Arm the guard and repair the cross-tool discovery symlinks: ./bin/setup # 4. Onboard in Claude Code (writes to a user/{name} branch on YOUR private origin): /bridge-onboard

/bridge-onboard then sets everything up and arms the pre-push guard before your user/{name} branch exists. On native Windows, run bin/setup.ps1 instead of ./bin/setup./bridge-onboard richtet dann alles ein und schaltet den pre-push-Guard scharf, bevor dein user/{name}-Branch existiert. Unter nativem Windows bin/setup.ps1 statt ./bin/setup ausführen.

The "Use this template" button works too, and the copy is private from the first second. But GitHub gives that copy a fresh history, so your first CORE update needs git merge --allow-unrelated-histories upstream/main once; every merge after that is ordinary.Der Knopf „Use this template" geht auch, privat ab der ersten Sekunde. GitHub gibt dieser Kopie aber eine frische History, deshalb braucht dein erstes CORE-Update einmalig git merge --allow-unrelated-histories upstream/main; jeder weitere Merge ist gewöhnlich.

Or hand it to your agentOder gib es deinem Agenten

One prompt: it plans, builds your private copy, verifies the guard, and onboards you.Ein Prompt. Er plant, baut deine private Kopie, verifiziert den Guard und onboardet dich.

Set up BKS open-bridge for me: https://github.com/bks-lab/open-bridge It is a plain-text memory layer (markdown + YAML in a git repo) that an AI coding agent reads at the start of every session. First, before you touch anything: check that git is installed, check whether the GitHub CLI (gh) is authenticated, ask me what to call my private copy (default: my-bridge), then show me your plan and wait for my go. Then, in this order: 1. Clone it and give it a PRIVATE home. The public repo ends up as a read-only "upstream", my own private repo as "origin": git clone https://github.com/bks-lab/open-bridge.git <name> cd <name> git remote rename origin upstream gh repo create <me>/<name> --private --source=. --remote=origin --push Use this order rather than GitHub's "Use this template" button: a template copy starts a fresh history, and the documented update path (git merge upstream/main) then refuses to run. No gh? Stop and ask me to create an empty PRIVATE repo on github.com, then continue with: git remote add origin <url> && git push -u origin main 2. Everything below runs inside <name>. Arm the safety hooks: ./bin/setup # native Windows: bin/setup.ps1 3. Record that my new origin is private. Without this the push guard cannot classify the target offline, and it refuses my first legitimate push: printf 'repo: <me>/<name>\nis_public: false\n' > .bridge-origin Do this only because the repo you created in step 1 is private. 4. Show me all three proofs: git remote -v # origin must be MY private repo git config core.hooksPath # must be scripts/hooks cat .bridge-origin 5. Stop here and tell me to restart you inside <name>. A session loads this repo's skills and instructions from the folder it starts in, so /bridge-onboard cannot exist in your current session, because that folder did not exist when it began. 6. In the new session it should greet me and offer the setup lanes by itself. If it does not, run /bridge-onboard. No slash commands? Read skills/bridge-onboard/SKILL.md, then skills/bridge-onboard/references/workflow.md, and run the phases with me inline. Hard rules: never push anything to bks-lab/open-bridge; my user/* branch goes only to my private origin; never write a secret into a file; ask me before anything destructive.
Richte BKS open-bridge für mich ein: https://github.com/bks-lab/open-bridge Das ist eine Plain-Text-Gedächtnisschicht (Markdown + YAML in einem Git-Repo), die ein KI-Coding-Agent zu Beginn jeder Session liest. Zuerst, bevor du irgendetwas anfasst: prüfe, ob git installiert ist, prüfe, ob die GitHub CLI (gh) eingeloggt ist, frag mich, wie meine private Kopie heißen soll (Default: my-bridge), zeig mir deinen Plan und warte auf mein Go. Dann, in dieser Reihenfolge: 1. Klone es und gib ihm ein PRIVATES Zuhause. Das öffentliche Repo wird zum read-only "upstream", mein eigenes privates Repo zum "origin": git clone https://github.com/bks-lab/open-bridge.git <name> cd <name> git remote rename origin upstream gh repo create <ich>/<name> --private --source=. --remote=origin --push Nimm diesen Weg statt GitHubs "Use this template"-Knopf: eine Template-Kopie beginnt eine frische History, und der dokumentierte Update-Pfad (git merge upstream/main) verweigert danach den Dienst. Kein gh? Halt an und bitte mich, ein leeres PRIVATES Repo auf github.com anzulegen, dann weiter mit: git remote add origin <url> && git push -u origin main 2. Alles Weitere läuft in <name>. Aktiviere die Safety-Hooks: ./bin/setup # natives Windows: bin/setup.ps1 3. Halte fest, dass mein neues origin privat ist. Ohne das kann der Push-Guard das Ziel offline nicht einordnen und verweigert meinen ersten legitimen Push: printf 'repo: <ich>/<name>\nis_public: false\n' > .bridge-origin Mach das nur, weil das in Schritt 1 angelegte Repo privat ist. 4. Zeig mir alle drei Nachweise: git remote -v # origin muss MEIN privates Repo sein git config core.hooksPath # muss scripts/hooks sein cat .bridge-origin 5. Halt hier an und sag mir, dass ich dich in <name> neu starten soll. Eine Session lädt die Skills und Anweisungen dieses Repos aus dem Ordner, in dem sie startet. /bridge-onboard kann es in deiner jetzigen Session nicht geben, weil dieser Ordner bei ihrem Start noch nicht existierte. 6. In der neuen Session sollte es mich begrüßen und die Setup-Wege von selbst anbieten. Falls nicht, führe /bridge-onboard aus. Keine Slash-Commands? Lies skills/bridge-onboard/SKILL.md, dann skills/bridge-onboard/references/workflow.md, und geh die Phasen interaktiv mit mir durch. Harte Regeln: niemals irgendetwas nach bks-lab/open-bridge pushen; mein user/*-Branch geht nur auf mein privates origin; niemals ein Secret in eine Datei schreiben; vor allen destruktiven Aktionen nachfragen.

Found a rough edge? Open an issue. It's the most useful thing you can do right now.Irgendwo hakt es? Öffne ein Issue. Das ist das Nützlichste, was du gerade tun kannst.