Deklariere einen Agenten in einer Markdown-Datei. Führ ihn in deinem Terminal aus.

Wege hinein

Zuerst dein Terminal. Dein Editor, wenn dir das lieber ist. Ein Host, wenn niemand an der Maschine sitzt.

Dieselbe Runtime, dieselben Deklarationen, derselbe Envelope, derselbe Sitzungszustand. Unterschiedlich ist nur, wer für die Maschine geradesteht, auf der es läuft.

Du schreibst die Regeln

Wie viel Agency? Das entscheidest du — schriftlich.

Jeder Lauf ist durch einen Envelope begrenzt: eine JSON-Policy, die benennt, was still durchläuft, was für einen Menschen pausiert und was verweigert wird — plus harte Obergrenzen für Tool-Aufrufe und Tokens und eine Festlegung, welche Modelle und Backends der Lauf nutzen darf. Kein versteckter Prompt entscheidet für dich. Die Datei liegt in deinem Repo und wird reviewt wie jede andere Änderung.

{
  "default_action": "approve",
  "compute": { "maxToolCalls": 300, "maxTokens": 2000000, "onExhausted": "finish_stuck" },
  "rules": [
    { "tools": "local_fs", "tool": "*", "action": "deny",
      "when": [{ "key": "path", "op": "glob",
                 "value": "**/{.ssh,.aws,.kube,.config/gcloud}/**" }] },
    { "tools": "local_fs", "tool": "read_file", "action": "allow" },
    { "tools": "local_fs", "tool": "write_file", "action": "approve" },
    { "tools": "local_shell", "tool": "local_shell", "action": "allow",
      "when": [{ "key": "command", "op": "command_prefix_allowlist",
                 "value": "go test,go vet,ls,cat,grep,npm test,pytest" }] },
    { "tools": "local_shell", "tool": "local_shell", "action": "approve" }
  ],
  "attention": { "allowAgentAnswers": false }
}

Gekürzt aus dem mitgelieferten Default-Preset. Was keine Regel trifft, schlägt geschlossen fehl — es fragt einen Menschen. Sechs Presets kommen mit contenox init, und contenox vet prüft deine Policy, bevor irgendetwas unter ihr läuft.

Der dauerhafte Ask

Der Lauf hält an. Der Prozess endet. Tage später setzt eine Antwort ihn fort.

Jedes Harness kann für einen Menschen pausieren, solange es die Verbindung offen hält. Die Verbindung zu halten ist nicht der schwere Teil — das Warten zu überleben schon. Ein contenox-Lauf checkpointet an der Stelle, an der er anhielt, gibt den Prozess frei und nimmt genau dort wieder auf, sobald jemand antwortet — von überall.

Kein Babysitten am Terminal, keine Freigabe, die verfällt, weil du geschlafen hast, keine stille Änderung, während du weg warst. Der Envelope hat entschieden, was unbeaufsichtigt laufen darf, die Deklaration nichts darüber hinaus, und eine Antwort hat den Lauf genau einmal fortgesetzt.

Das Artefakt

Ein Agent ist eine Datei. Ein Workflow ist ein Verzeichnis.

Eine Deklaration ist Markdown mit YAML-Frontmatter: ein Name, die Tools, die sie aufrufen darf, das Modell — und ein Rumpf, der zum System-Prompt wird. Leg Deklarationen in ein Verzeichnis, und das Verzeichnis ist der Workflow: Die agent.md an der Spitze liest die Anfrage, antwortet mit einem Label, und der Zweig dieses Namens übernimmt — mit eigener Instruktion, eigenen Tools, eigenem Budget.

default: im Frontmatter des Routers benennt den Zweig, in den ein unbekanntes Label fällt — den engsten, nie den mächtigsten. contenox kompiliert das Verzeichnis beim nächsten Lauf in die Chain, die es ausführt, und die Policy, unter der sie läuft — nach .generated/. Beide sind JSON-Schema-validiert, beide darfst du lesen, keine musst du pflegen.

• →Ein Zweig ist Spezialist durch das, was er hält, nicht durch seine Formulierung: Benenne seine Tools, und jedes andere wird dort entzogen, wo Aufrufe ausgeführt werden — nicht dadurch, dass man es dem Modell bloß nicht anbietet.
• →Ein Support-Desk schickt Abrechnungsfragen an einen lesenden Zweig mit der Billing-API und Kontoänderungen an einen, der schreiben darf, aber für einen Menschen anhält.
• →Ein Backoffice schickt „fasse das zusammen“ und „extrahiere diese Felder“ an Zweige mit unterschiedlichen Ausgabe-Kontrakten — der Aufrufer bekommt parsebare Ausgabe, ohne jedes Mal darum zu bitten.
• →Eine regulierte Installation schickt alles, was regulierte Daten berührt, an einen Zweig unter strengerem Envelope — unabhängig davon, wie die Anfrage formuliert war.

Tools

Bring die Tools mit, die du brauchst. Sonst nichts.

contenox liefert keine eigenen Tools mit. Es besitzt die Tool-Grenze — was auf der anderen Seite steht, entscheidest du. Jedes Tool, das du nicht brauchst, sind Tokens auf jedem Turn und eine Sache mehr zu regeln. Tools überqueren diese Grenze auf zwei Wegen — und beide wählst du.

Von welcher Seite ein Aufruf auch kommt: Er überquert eine Grenze und wird gegen einen Envelope geprüft, bevor er läuft.

Das Argument

Apache machte Ausliefern zu etwas, das man installiert. HTML wurde zu etwas, das man schreibt.

Fünf Agenten liegen bei. Sie sind die Standardseite, nicht das Produkt — ein Beispiel für das Artefakt, dazu da, durch deines ersetzt zu werden. Und da hört die Analogie auf: Apache lieferte keinen Browser mit, contenox liefert einen. contenox beam ist er — erste Hand, im selben Repository, damit die Vordertür nie das Produkt von jemand anderem ist. Ein Client bleibt er trotzdem: Die Policy, die er anzeigt, wird unter ihm durchgesetzt, nicht von ihm.

Standardmäßig deins

Dein Rechner, dein Zustand, deine Modelle.

• →Sessions, Konfiguration, Run-Logs und erfasster Ausführungszustand liegen auf deinem Rechner. Kein Konto, kein contenox-Dienst dazwischen — außer du pairst mit dem optionalen Relay unten. Telemetrie ist opt-in und standardmäßig aus.
• →Inferenz ist Konfiguration: lokales Ollama oder vLLM, wenn nichts dein Netzwerk verlassen darf — oder OpenAI, Anthropic, Gemini, Bedrock und Vertex mit deinen eigenen Schlüsseln, gepinnt auf eine Region deiner Wahl. Ein späterer Wechsel ist eine Konfigurationsänderung, kein Umbau.
• →Secrets werden zur Anfragezeit aus deiner Umgebung aufgelöst und landen nie in einer Config auf der Platte. Jeder Envelope verweigert .ssh, .aws und .kube unter jeder Berechtigungsstufe, auch der lockersten.

Optional: das gehostete Relay

Deine Session, auf deinem Handy.

Alles oben läuft ohne Konto. Wenn eine laufende Session von woanders erreichbar sein soll, pairst du den Rechner mit dem gehosteten Relay: ein getippter Schlüssel aus der contenox-App, kein Browser auf der Maschine. Der Rechner baut die Verbindung selbst nach außen auf und sendet genau zwei Dinge — den Schlüssel und seinen Hostnamen. Danach liest du das Transkript und beantwortest Freigaben vom Handy. Kostenlos für dich und drei Teamkollegen, je eine Maschine — und eine Installation, die nie pairt, kontaktiert kein Relay.

Wir provisionieren und betreiben contenox-Agenten auch für dich — managed, zu deinen Bedingungen. Sag uns, worum es geht, und wir richten es ein: sprich mit uns · die gehostete App ansehen