okfshare CLI und MCP-Server

Der clientseitige, quelloffene Teil von okfshare: gemeinsames, versioniertes Wissen für KI-Coding-Agenten.

Veröffentlichen Sie ein validiertes Markdown-Bundle genau einmal. Jeder autorisierte Agent arbeitet auf Grundlage derselben unveränderlichen Revision, mit Zitaten auf Zeilenebene, die Sie prüfen können. Der gehostete Dienst verwaltet Revisionen, Zitate und die Workspace-Authentifizierung; dieses Repository enthält die Werkzeuge, die Ihre Agenten tatsächlich ausführen.

Pakete

Related MCP server: JacBrain

Schnellstart

# 1. One-time onboarding (device pairing in your browser)
npx okfshare@latest setup

# 2. Validate and publish a folder of Markdown
npx okfshare@latest validate ./knowledge
npx okfshare@latest publish ./knowledge --visibility public --yes

# 3. Any teammate's agent retrieves cited context
npx okfshare@latest context SHARE_ID "how do we handle db migrations"

Headless-/CI-Umgebungen: Stellen Sie über die Umgebungsvariable OKFSHARE_TOKEN eine vorab bereitgestellte Anmeldeinformation bereit (nur auf Existenz prüfen; niemals protokollieren) und verifizieren Sie den Zugriff anschließend mit whoami und doctor.

MCP-Setup

claude mcp add okfshare -- npx @okfshare/mcp@latest

Oder mit einem beliebigen MCP-Client:

{
  "mcpServers": {
    "okfshare": {
      "command": "npx",
      "args": ["@okfshare/mcp@latest"]
    }
  }
}

Werkzeuge: whoami, doctor, list_shares, search_share, search_workspace, get_context, pull_bundle, publish_bundle. Registry-Manifest: server.json.

Warum Zitate wichtig sind

Die Abfrage liefert die Datei, die exakten Zeilen und die unveränderliche Revision, aus der sie stammen. Wenn ein Agent behauptet „unsere Konvention besagt X“, können Sie die Behauptung in Sekunden prüfen – und ein Zitat bedeutet auch morgen dasselbe, denn der Inhalt einer Revision wird nie an Ort und Stelle geändert.

Das Open Knowledge Format

Bundles sind Markdown mit strukturiertem Frontmatter: ein type, Titel, Beschreibung, Tags, Quellen und Verifikationsereignisse. Das Format ist bewusst schlank gehalten und bleibt in jedem Editor lesbar. Im schlimmsten Fall haben Sie am Ende schlichte Dateien – kein Lock-in.

• Spezifikation: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md

• Field Guide (veröffentlicht mit okfshare selbst): https://okfshare.app/s/ecf08367a22273482c0887aab700ee8e

• Fork-fähige Startvorlage für Konventionen: https://okfshare.app/s/e8ddada5aab619495c970f031dce7058

Entwicklung

pnpm install
pnpm check   # typecheck + test + build across all packages

• Node 20+ und Auto pnpm 10.

• Die Pakete kommunizieren mit der gehosteten API unter https://okfshare.app – für die Entwicklung ist also kein lokaler Server erforderlich.

• Siehe CONTRIBUTING.md für den Abnahmeprozess und SECURITY.md für die Meldung von Sicherheitslücken.

Links

• Website und Dokumentation: https://okfshare.app

• Für Agenten lesbare Dokumentation: https://okfshare.app/llms.txt und https://okfshare.app/llms-full.txt

Lizenz

Apache-2.0. Siehe NOTICE – die Codelizenz gewährt keine Rechte am Namen oder am Branding von okfshare.