LiteContext CLI

LiteContext CLI ist eine lokal-basierte Kontext-Engine und ein MCP-Server für persönliches Wissen. Es indexiert lokale Markdown- oder Obsidian-Ordner, bewahrt Quellzitate und ermöglicht kompatiblen KI-Clients, relevante lokale Kontexte über MCP abzurufen.

Es läuft ohne Desktop-Anwendung, Browser, Cloud-Konto oder localhost-UI. Ihre Quellen und Indizes bleiben standardmäßig in ~/.litecontext.

Installation

Die Go-Engine ist derzeit eine schreibgeschützte Kompatibilitätsvorschau. Sie öffnet den vorhandenen LiteContext-v1-JSON-Arbeitsbereich, wendet Context-Profile-Grenzen an und bietet zitiertes Suchen, Doctor und MCP stdio ohne Node zur Laufzeit:

go run ./cmd/litecontext doctor --workspace ~/.litecontext --json
go run ./cmd/litecontext search --workspace ~/.litecontext --query "project roadmap" --json
go run ./cmd/litecontext mcp serve --workspace ~/.litecontext

Es schreibt noch keine Quellen, Profile oder SQLite. Die TypeScript-CLI bleibt während der Migration die Kompatibilitätsbasis für diese Operationen. Die erste Go-Binärversion wird über GitHub Releases und Homebrew verteilt; npm ist keine erforderliche Produktlaufzeit.

Related MCP server: ragi

Aktuelle TypeScript-CLI-Basis

litecontext source add ~/Documents/notes --source-id notes --name "Personal notes"
litecontext source list
litecontext doctor
litecontext serve --mcp

Für einen Obsidian-Vault fügen Sie --source-type obsidian hinzu. source add erstellt ein Standard-Context-Profil, sofern nicht --no-default-profile angegeben wird. Verwenden Sie source sync <id>, um eine Quelle zu aktualisieren, und source remove <id>, um nur LiteContexts lokalen Index und Registrierungseinträge zu entfernen, niemals die Originaldateien.

MCP-Konfiguration

Drucken Sie eine einfügbare Konfiguration für einen KI-Client aus:

litecontext mcp-config --global

Der Serverbefehl lautet litecontext serve --mcp. Der MCP-Server liest denselben lokalen Arbeitsbereich, wenn keine Desktop-Anwendung ausgeführt wird.

Arbeitsbereich und Architektur

Local Markdown / Obsidian
  -> connectors and ContextItem normalization
  -> SQLite/FTS index + Context Profile
  -> LiteContext CLI / MCP stdio
  -> cited local context for an AI client

• @litecontext/core — Verträge, Profile, SQLite/FTS-Index, Abruf.

• @litecontext/connectors — portable Quellkonnektoren.

• @litecontext/cli — Quelllebenszyklus-Befehle, Diagnose und MCP-Server.

Entwicklung

Das Übergangsrepository verifiziert derzeit sowohl die TypeScript-Basis als auch die Go-Read-only-Engine. Es erfordert Go 1.24.1, Node 24.13–24.x und pnpm 10.

pnpm install
pnpm check
pnpm audit:security

pnpm check führt die gemeinsamen Golden-Fixture-Tests für beide Implementierungen aus.

Siehe CONTRIBUTING.md, SECURITY.md, Third-Party-Hinweise und den Release-Leitfaden.

Lizenz

MIT