Archcore MCP

Archcore CLI — Git-nativer Kontext für KI-Codierungsagenten

Archcore ist umgezogen zu github.com/archcore-ai/archcore. Dieses Repository ist archiviert. Die CLI lebt jetzt unter cli/ in diesem Repository, neben dem Plugin, und jede Veröffentlichung ab v0.10.1 wird unter archcore-ai/archcore/releases veröffentlicht. Installieren oder aktualisieren Sie mit curl -fsSL https://archcore.ai/install.sh | bash auf macOS, Linux und WSL oder irm https://archcore.ai/install.ps1 | iex unter Windows. Eine aus diesem Repository installierte Binärdatei (v0.8.7 oder früher) aktualisiert sich nicht mehr selbst. Führen Sie den Installer einmal aus, um zum neuen Kanal zu wechseln. Probleme: archcore-ai/archcore/issues.

Archcore ist eine git-native Kontextebene für KI-Codierungsagenten.

Die CLI hält Spezifikationen, Architekturentscheidungen, Regeln, Pläne und Projektwissen in .archcore/, versioniert mit Ihrem Code, und liefert den relevanten Kontext über MCP und Session-Hooks an Codierungsagenten.

Sie wird als CLI und lokaler stdio-MCP-Server ausgeliefert, sodass jeder MCP-kompatible Codierungsagent Ihren Projektkontext über Standardwerkzeuge lesen und schreiben kann. Nutzen Sie sie für persistenten Projektkontext in Claude Code, Cursor, Codex CLI, GitHub Copilot, Gemini CLI, OpenCode, Roo Code und Cline.

So funktioniert es

Dieser Kontext stammt aus .archcore/ — getippten Markdown-Dokumenten, die in Git versioniert und über MCP-Werkzeuge und Session-Hooks an jeden Agenten ausgeliefert werden.

Was sich ändert

❌ Ohne Archcore

Jede Sitzung beginnt bei null. Der Agent:

• rät Ihre Architektur und bricht Ihre Konventionen
• dupliziert Logik, die bereits existiert
• verhandelt Entscheidungen neu, die Ihr Team bereits getroffen hat
• benötigt denselben Kontext in jedem Chat erneut erklärt

✅ Mit Archcore

Ihre Entscheidungen, Regeln und Konventionen leben in Git als strukturierter Kontext. Der Agent:

• lädt die geltenden Entscheidungen und Regeln zu Sitzungsbeginn
• platziert Code dort, wo Ihre Architektur ihn vorsieht
• respektiert die ADRs, Spezifikationen und Regeln, die bereits im Repository liegen
• zeichnet neue Entscheidungen als dauerhaften Kontext auf — überprüfbar in PRs, übertragbar zwischen Agenten

Der Agent hört auf zu raten und beginnt, dem System zu folgen.

In 60 Sekunden loslegen

curl -fsSL https://archcore.ai/install.sh | bash    # macOS / Linux
cd your-project && archcore init

archcore init richtet .archcore/ ein, erkennt Ihre Codierungsagenten und verdrahtet Hooks und MCP für sie.

Öffnen Sie dann Ihren Agenten und sagen Sie:

„Wir verwenden PostgreSQL für die primäre Speicherung. Halten Sie diese Entscheidung fest."

Fertig — es gibt jetzt eine strukturierte ADR in .archcore/, die jede zukünftige Sitzung in jedem Agenten sehen wird.

Unter Windows: irm https://archcore.ai/install.ps1 | iex. Für WSL, go install und das Erstellen aus dem Quellcode siehe Installationsmethoden unten oder die vollständige Installationsanleitung.

Funktioniert mit Ihrem Agenten

Die CLI ist selbst ein lokaler stdio-MCP-Server — eine Integrationsfläche für jeden MCP-kompatiblen Agenten. Hooks fügen Kontext zu Sitzungsbeginn hinzu, wo der Agent sie unterstützt.

archcore init konfiguriert erkannte Agenten automatisch. So verdrahten Sie einen von Hand:

archcore mcp install --agent cursor      # write MCP config for a specific agent
archcore hooks install                   # install session-start hooks for detected agents
claude mcp add --transport stdio archcore -- archcore mcp   # or add the server manually

So funktioniert es

1. Initialisieren — archcore init erstellt .archcore/ und installiert Agentenintegrationen.
2. Erfassen — Entscheidungen, Regeln, Pläne und Anleitungen werden als getippte Markdown-Dokumente mit YAML-Frontmatter gespeichert.
3. Wiederverwenden — Agenten lesen, erstellen, aktualisieren und verknüpfen Dokumente über MCP-Werkzeuge, während sie arbeiten; Hooks laden Kontext zu Sitzungsbeginn.
4. In Git halten — Kontextänderungen wie Code überprüfen, im Laufe der Zeit weiterentwickeln, zwischen Werkzeugen übertragbar halten.

.archcore/
├── settings.json
├── auth/
│   ├── jwt-strategy.adr.md
│   └── auth-redesign.prd.md
├── backend/
│   └── error-wrapping.rule.md
├── incidents/
│   └── connection-pool-exhaustion.cpat.md
└── notifications/
    └── notifications-implementation.plan.md

Die Struktur ist frei gestaltbar — organisieren Sie nach Domäne, Feature oder Team. Der Typ eines Dokuments steht in seinem Dateinamen (slug.type.md): 23 Typen in drei Ebenen — Wissen (ADRs, Regeln, Spezifikationen, Anleitungen), Vision (PRDs, Pläne, Ideen, Anforderungsspuren) und Erfahrung (Incident-Muster, wiederkehrende Aufgaben). Das eigene .archcore/ dieses Repositories ist ein funktionierendes Beispiel.

Fragen Sie Ihren Agenten

„Bevor ich das Auth-Modul anfasse, welche Entscheidungen und Regeln gelten hier?"

Lädt die ADRs und Regeln, die mit diesem Bereich verbunden sind, bevor der Agent eine einzige Zeile bearbeitet.

„Wir haben eine Konvention: Fehler immer mit fmt.Errorf und %w umschließen. Machen Sie das zu einer Regel."

Erstellt backend/error-wrapping.rule.md mit imperativer Anleitung, Begründung und guten/schlechten Beispielen.

„Letzte Woche hatten wir einen Vorfall mit Erschöpfung des Verbindungspools. Dokumentieren Sie ihn, damit wir ihn nicht wiederholen."

Erstellt incidents/connection-pool-exhaustion.cpat.md mit Ursachenanalyse und Präventionsschritten.

Wie es sich vergleichen lässt

Nicht für — Chat-Speicher, eine Prompt-Bibliothek oder einen einmaligen Spezifikations-zu-Code-Generator. Archcore ist eine Repository-Wahrheitsebene für Codierungsagenten, kein Methodik-Kit.

Referenz

Was im Paket enthalten ist: 23 Dokumenttypen, 7 Beziehungstypen, 10 MCP-Werkzeuge, Hook-Integrationen für 4 Agenten und MCP-Integrationen für 8.

---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---

## Context

...

curl -fsSL https://archcore.ai/install.sh | bash

irm https://archcore.ai/install.ps1 | iex

go install github.com/archcore-ai/cli@latest

git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .

archcore config                    # show all settings
archcore config get <key>          # get a specific value
archcore config set <key> <value>  # set a value

Ökosystem

• Archcore-Plugin – Nutzen Sie Claude Code oder Cursor? Das Plugin paart sich mit der CLI: dieselbe Engine, plus Fähigkeiten, Absichtsbefehle und Schutzmechanismen. Ein Produkt, zwei Einstiegspunkte – die CLI allein deckt jeden anderen Agenten ab.
• docs.archcore.ai – vollständige Dokumentation.
• .archcore/ in diesem Repository – ein lebendiges Beispiel: Die CLI ist mit ihrer eigenen Kontextschicht gebaut.

Entwicklung

Erfordert Go 1.25+.

go build -o archcore .   # build
go test ./...            # run all tests

Links & Lizenz

• Dokumentation: docs.archcore.ai
• Website: archcore.ai
• Plugin (Claude Code, Cursor): github.com/archcore-ai/plugin
• Probleme: github.com/archcore-ai/cli/issues
• Lizenz: Apache 2.0