code-quorum

Unabhängige Reviews sind zu einem wichtigen Teil meiner Nutzung agentischer Tools geworden. Inspiriert von ähnlichen Arbeiten habe ich Code Quorum für den eigenen Gebrauch gebaut und teile es, falls es auch anderen nützlich ist.

Code Quorum ist ein macOS-Multi-Agenten-Rat für Claude Code und Codex. Der aktive Host schreibt sein eigenes Review, seine eigene Bewertung oder seinen eigenen Plan, während externe Sitze parallel arbeiten. Ein strukturelles Anti-Bias-Gate hält jede Perspektive bis zur finalen Synthese unabhängig.

Es kann bestehende Claude Code-, ChatGPT/Codex- und Gemini/Antigravity-Abonnements nutzen. Der OpenCode-Sitz verwendet OpenRouter, mit DeepSeek V4 Flash als Standardmodell. Beide CLI-Hosts werden unterstützt, ebenso wie Codex in der ChatGPT-Desktop-App und die Code-Oberfläche in der Claude-Desktop-App.

Der Host ist niemals gleichzeitig ein Subprozess-Sitz. Die Start/Await-Trennung erfordert, dass der Host seine eigene Antwort bildet, bevor q_await Peer-Ausgaben offenlegt, und jede Council-Skill ruft die blockierende Abschlussbenachrichtigung im selben Turn wie ihren Start auf.

Externe Sitze sind schreibgeschützt, aber schreibgeschützt bedeutet nicht datenlokal. Lesen Sie Sicherheit und Datengrenzen, bevor Sie Code Quorum für privates Material verwenden.

Jeder repository-lesende MCP-Council-Start erfordert ein explizites absolutes Projekt-cwd. Die MCP-Tools lehnen einen fehlenden oder leeren Wert ab, anstatt auf das Plugin-Cache- oder Laufzeitverzeichnis des Servers zurückzufallen. Die Host-Skills liefern diesen Wert bei normaler /q-*- und $code-quorum:q-*-Nutzung. Plan- und Scope-Dateien müssen ebenfalls innerhalb dieses Verzeichnisses aufgelöst werden; absolute Pfade, ..-Traversierung und Symlink-Escapes werden abgelehnt, bevor ihre Inhalte gelesen werden.

Workflows

Der Host kann einen Workflow aus einer passenden Klartext-Anfrage auswählen. Verwenden Sie die folgenden Formulare, um einen explizit auszuwählen:

uv run quorum --help listet die genaue Shell-Oberfläche auf. Die wichtigsten Modifikatoren sind:

Forschungsquellen und Anmeldedaten

q-research fragt standardmäßig alle sechs Quellen ab. Wiederholen Sie --source <name>, um einen Lauf einzuschränken.

Code Quorum liest Anmeldedaten aus der Prozessumgebung und sendet Tokens nur in Autorisierungs-Headern. Der generierte Codex-Adapter leitet die benannten Variablen weiter, speichert ihre Werte jedoch nicht im Plugin-Artefakt. OpenAlex ist die einzige Quelle, die für die normale Nutzung einen Schlüssel erfordert; die anderen verbessern Zuverlässigkeit oder Ratenlimits.

Überprüfen Sie die Hugging-Face-Suche aus einem Checkout mit:

uv run quorum research "sentence embedding" --source huggingface --limit 5
uv run pytest tests/test_research_live.py -m live -k huggingface -q

Der CLI-Check muss Modell-Links und eine von Null verschiedene HuggingFace-Quellenanzahl zurückgeben. Die Live-Tests decken direkte Suche, konfigurierte Token-Authentifizierung, Vereinigung markanter Begriffe und den vollständigen research_topic-Pfad ab. Ohne Token überspringt der Authentifizierungstest, während anonyme Prüfungen weiterhin laufen.

Anforderungen

Code Quorum unterstützt derzeit macOS und erfordert Python 3.13+, den uv-Paketmanager und die Binärdateien für die Sitze, die Sie verwenden möchten. Jeder Sitz verlässt sich auf seinen eigenen Login oder Schlüssel; Code Quorum schreibt keine Anmeldedatenwerte in Plugin-Artefakte. Sitz-CLIs behalten ihre eigene Authentifizierung und ihren eigenen Laufzeitzustand, wie in SECURITY.md beschrieben.

Der Gemini-Sitz hängt von der macOS-Seatbelt-Sandbox ab; Claude verwendet stattdessen eine Read-Tool-Allowlist. Ein Codex-Host benötigt außerdem einen eng begrenzten LaunchAgent-Helfer für seine Claude- und Gemini-Sitze. Codex und OpenCode haben keine Seatbelt-Abhängigkeit, sind aber auf anderen Plattformen ungetestet.

Installation

Klonen Sie den stabilen Checkout und konfigurieren Sie die Sitze:

git clone https://github.com/sdewell/code-quorum.git
cd code-quorum
uv sync
agy  # complete Google OAuth login, then exit
uv run quorum setup-agy                    # one-time Gemini seat config
uv run quorum setup-models --host claude   # use --host codex for Codex
uv run quorum doctor --host claude         # or codex / both
uv run quorum auth-check --seat gemini --host claude

doctor prüft Binärdateien, Konfigurationsform und Sandbox-Bereitschaft. Es testet keine Live-Anmeldedaten. auth-check führt agy models in derselben Sandbox aus, die auch der Sitz verwendet, und erfordert mindestens eine gültige Modellzeile, ohne eine Modellaufforderung zu senden. Ein fehlender oder widerrufener Login führt den Benutzer zurück zu interaktivem agy; Code Quorum wechselt niemals stillschweigend zu einer nutzungsbasierten API-Route.

Installieren und verifizieren Sie auf einem Codex-Host den Helfer aus einem echten Terminal, bevor Sie die Codex-Authentifizierungsprüfung durchführen:

uv run quorum install-seat-helper-launchagent   # --allowed-root <dir> to widen
uv run quorum seat-helper-status
uv run quorum auth-check --seat gemini --host codex

Jeder MCP-Workflow erlaubt standardmäßig cwd unter ~/Code und ~/src; der Codex-Helfer wendet dieselben Wurzeln an, bevor er Claude- oder Gemini-Anfragen akzeptiert. Setzen Sie CODE_QUORUM_HELPER_ALLOWED_ROOTS oder installieren Sie den Helfer mit wiederholten --allowed-root-Optionen, um andere Projektwurzeln zu verwenden. Installieren Sie ihn nach jedem Code-Quorum-Upgrade aus dem aktualisierten stabilen Checkout neu. Inkompatible Helfer-Protokolle schlagen geschlossen fehl, und die Installation aus dem ersetzbaren Plugin-Cache von Codex wird abgelehnt.

Schreibgeschützte Grenzen

Jeder externe Sitz ist schreibgeschützt und weigert sich zu laufen, wenn seine Grenze nicht angewendet werden kann. Die Durchsetzung unterscheidet sich je nach Sitz: Codex verwendet seine native schreibgeschützte Sandbox, Claude legt nur Lesetools offen, Gemini verwendet macOS-Seatbelt und OpenCode verwendet ein isoliertes HOME mit eingeschränkten Berechtigungen.

Das Seatbelt-Profil von Gemini verweigert andere Lesezugriffe auf das Home-Verzeichnis, mit expliziten Ausnahmen für agy-Authentifizierung und Laufzeitzustand. Es verweigert keine lesbaren Pfade außerhalb von $HOME. Code Quorum bietet keinen universellen Pfadzaun für Claude, Codex oder OpenCode. Ratsmaterial kann die Maschine unter den vom Benutzer konfigurierten Provider-Konten verlassen. Die vollständige Grenztabelle, Datenabflusskarte, Anleitung zur strikten Isolierung und Handhabung von Anmeldedaten finden Sie in SECURITY.md.

Daten und Genehmigungen auf Codex

Codex behandelt Tool-Genehmigung, Dateisystem-Eindämmung und die Autorisierung, Material außerhalb der Maschine zu senden, als getrennte Entscheidungen. Ein Ziel wie main...HEAD begrenzt den vorbereiteten Review-Diff; es schränkt den schreibgeschützten Zugriff eines externen Sitzes auf das Arbeitsverzeichnis nicht ein.

Wenn approvals_reviewer = "auto_review" aktiviert ist, kann ein Council-Start eine explizite Autorisierung erfordern, die die Nutzlast und die Empfänger benennt. Benutzer, die unbeaufsichtigten Zugriff wünschen, können pro Tool opt-in, aber Code Quorum schreibt diese Genehmigungseinträge niemals selbst.

SECURITY.md enthält das einmalige Autorisierungsbeispiel, alle sechs Codex-Genehmigungsblöcke (einschließlich des gemeinsamen q_await-Tools), die Projekt-AGENTS.md-Anleitung, die Pfadbegrenzungen und das genehmigungserhaltende Aktualisierungsverfahren. Überprüfen Sie es, bevor Sie unbeaufsichtigte Workflows aktivieren.

Konfiguration

Jeder Sitz löst sein Modell über eine Leiter auf, wobei der erste Treffer gewinnt: Lauf-Flag -> Umgebungsvariable -> die von quorum setup-models aufgezeichnete Auswahl -> der ausgelieferte Pin. Aufgezeichnete Auswahlen ändern sich nie stillschweigend; ein Sitz, der eine nicht erfüllen kann, schlägt laut fehl, während der Rest des Rats fortfährt.

uv run quorum setup-models --host claude
uv run quorum setup-models --seat codex --model gpt-5.6-terra --effort medium

OpenCode-Konfiguration

Der OpenCode-Sitz erfordert OPENROUTER_API_KEY und lädt nicht Ihre persönliche OpenCode-Konfiguration. Er verwendet ein isoliertes HOME und erstellt diese generierte Konfiguration vor jedem Lauf neu. Das ausgelieferte Modell ist openrouter/deepseek/deepseek-v4-flash; sein OpenRouter-chunkTimeout beträgt 90000 Millisekunden.

Code Quorum setzt OPENCODE_DISABLE_PROJECT_CONFIG=1 und OPENCODE_PURE=1. Der generierte Rats-Agent erlaubt nur Read, glob und list, verweigert Shell- und Mutationswerkzeuge, blockiert .env und .env.* und erlaubt .env.example. Fehlgeschlagene oder leere Läufe schreiben rohe stdout/stderr-Erfassungen nach ~/.cache/code-quorum/opencode-debug, sofern nicht CODE_QUORUM_OPENCODE_DEBUG=0 gesetzt ist. Das Verzeichnis hat die Berechtigung 0700, Erfassungsdateien 0600, Prompt-Text wird aus den Befehlsmetadaten ausgelassen, und nur die neuesten 20 Erfassungen werden aufbewahrt. Rohe Streams können dennoch überprüftes Material enthalten. Siehe ARCHITECTURE.md und SECURITY.md für das vollständige Grenzdesign.

Deaktivieren eines Sitzes

Wenn eine Live-Überprüfung fehlschlägt, weil ein Sitz fehlt oder abgemeldet ist, kann quorum setup-models ihn in models.toml als disabled markieren. Deaktivierte Sitze werden von der Standard-Roster übersprungen und von doctor gemeldet, aber eine explizite --agent <seat>-Anfrage führt sie weiterhin aus.

Als Plugin installieren

Claude Code:

/plugin marketplace add sdewell/code-quorum
/plugin install code-quorum@code-quorum

Laden Sie für die Claude Code CLI OPENROUTER_API_KEY und optionale Forschungsschlüssel, bevor Sie den Host starten. Zum Beispiel:

source ~/.zshrc.local
claude

Stellen Sie für die Claude-Desktop-App die Schlüssel der aktuellen macOS-Anmeldesitzung zur Verfügung, bevor Sie sie öffnen:

source ~/.zshrc.local
launchctl setenv OPENROUTER_API_KEY "$OPENROUTER_API_KEY"

Der launchctl-Wert wird von jeder danach gestarteten Anwendung geerbt, bis er entfernt wird, eine Abmeldung erfolgt oder der Computer neu startet. Starten Sie Claude Code und entfernen Sie dann die Kopie der Anmeldesitzung; die bereits laufende App behält ihre Kopie für Plugin-Subprozesse:

launchctl unsetenv OPENROUTER_API_KEY

Nach der Installation oder Aktualisierung des Plugins oder nach dem Ändern eines Schlüssels beenden Sie Claude Code vollständig und starten Sie eine neue Claude Code-Sitzung. Ein Plugin-Neuladen kann Codeänderungen übernehmen, kann aber die vom laufenden Host geerbte Umgebung nicht ändern.

Das Claude-Plugin startet seinen MCP-Server mit uv run --directory ${CLAUDE_PLUGIN_ROOT} quorum-mcp, daher müssen uv und Python 3.13+ im PATH sein.

Codex:

Registrieren Sie den öffentlichen Marktplatz und installieren Sie das Plugin:

codex plugin marketplace add sdewell/code-quorum --ref main
codex plugin add code-quorum@code-quorum
codex plugin list

Beenden Sie für die ChatGPT-Desktop-App die App vollständig und öffnen Sie sie nach der Registrierung des Marktplatzes erneut. Öffnen Sie Plugins, wählen Sie Persönlich, wählen Sie Code Quorum und klicken Sie auf Installieren.

Nachdem eine der beiden Codex-Oberflächen das Plugin installiert hat, bereiten Sie den stabilen Checkout von einem echten Terminal aus vor:

uv sync
uv run quorum install-seat-helper-launchagent
uv run quorum seat-helper-status

Der Codex-Launcher startet das vorbereitete .venv dieses Checkouts direkt. Der MCP-Start hängt daher nicht von einem beschreibbaren uv-Cache, Netzwerk-Downloads oder einer Umgebung innerhalb des austauschbaren Plugin-Verzeichnisses ab. Nach jedem Upgrade ziehen Sie den Checkout, führen Sie uv sync aus und installieren Sie den Helfer neu, bevor Sie einen neuen Codex-Thread starten.

Öffnen Sie in der Codex CLI /hooks, um jeden code-quorum-Befehlshook zu überprüfen und zu vertrauen. Codex überspringt Plugin-Hooks, bis jeder aktuelle Definitions-Hash vertraut wird. Eine geänderte Definition erfordert eine erneute Überprüfung und Vertrauen für diese geänderte Definition.

Der generierte Launcher stellt standardmäßige Benutzer- und Homebrew-Binärverzeichnisse (~/.local/bin, ~/.opencode/bin, /opt/homebrew/bin und /usr/local/bin) für eine Desktop-App mit einem minimalen PATH wieder her.

Laden Sie für die Codex CLI die Schlüsselumgebung, bevor Sie Codex starten. Für die ChatGPT-Desktop-App setzen Sie die Schlüssel in der aktuellen macOS-Anmeldesitzung:

source ~/.zshrc.local
launchctl setenv OPENROUTER_API_KEY "$OPENROUTER_API_KEY"

Der Wert ist für jede danach gestartete Anwendung sichtbar, bis er entfernt wird. Starten Sie Codex und entfernen Sie dann die Kopie der Anmeldesitzung; die laufende App behält den Wert, den sie bereits geerbt hat:

launchctl unsetenv OPENROUTER_API_KEY

Beenden Sie nach einem Plugin-Upgrade oder einer Schlüsseländerung Codex vollständig und öffnen Sie es erneut, und starten Sie einen brandneuen Codex-Thread. Setzen Sie keinen Thread fort, der vor dem Neustart erstellt wurde; seine Tool-Registrierung kann sich weiterhin auf den vorherigen Plugin-Prozess beziehen.

Verwenden Sie für genehmigungserhaltende Aktualisierungen niemals codex plugin remove als normalen Weg. Befolgen Sie die verifizierte Sequenz in SECURITY.md.

Design

ARCHITECTURE.md beschreibt die gemeinsame CLI/MCP-Spine, Sitz-Adapter, Rundenmodell, Anti-Bias-Mechanismen, Paketierung und Fehlergrenzen. Die Kurzversion: Runde 1 enthält keine Peer-Ausgabe, spätere Runden anonymisieren Peers nach Standpunkt, und der Host erhält die Ratsmatrix erst bei q_await.

Namensnennung

Diese Projekte inspirierten die Workflow-Form; es wurden kein Code, keine Prompts und keine Dokumentation kopiert:

• SnakeO/claude-co-commands - unabhängige Host-Arbeit vor der Peer-Ausgabe.

• agentic-box/owlex - Multi-Agenten-Ratsarchitektur und kognitive Rollen.

• karpathy/llm-council - anonymisierte Peer-Überprüfung nach Inhalt statt nach Modellidentität.

Lizenz

MIT.