cli-anything-mubu

Was macht cli-anything-mubu?

Kanonisch gepackter Einstiegspunkt für die Mubu Live-Bridge.

Installation

Diese CLI wird aus dem kanonischen agent-harness Quellbaum gepackt:

pip install -e .

Voraussetzungen:

• Python 3.10+
• Eine aktive Mubu-Desktop-Sitzung auf diesem Rechner
• Lokale Mubu-Profildaten, die der CLI zur Verfügung stehen
• Setzen Sie MUBU_DAILY_FOLDER, wenn Sie die täglichen Helfer ohne Argumente verwenden möchten

Einstiegspunkte

cli-anything-mubu
python -m cli_anything.mubu

Wenn die CLI ohne Unterbefehl aufgerufen wird, startet sie eine interaktive REPL-Sitzung.

Befehlsgruppen

Entdecken

Entdeckungsbefehle für Ordner, Dokumente, Aktualität und Auflösung täglicher Dokumente.

Befehl	Beschreibung
docs	Listet die neuesten bekannten Dokumentschnappschüsse aus lokalen Backups auf.
folders	Listet Ordnermetadaten aus dem lokalen RxDB-Speicher auf.
folder-docs	Listet Dokumentmetadaten für einen Ordner auf.
path-docs	Listet Dokumente für einen Ordnerpfad oder eine Ordner-ID auf.
recent	Listet kürzlich aktive Dokumente anhand von Backups, Metadaten und Synchronisationsprotokollen auf.
daily	Findet Ordner vom Typ "Daily" und listet die darin enthaltenen Dokumente auf.
daily-current	Ermittelt das aktuelle tägliche Dokument aus einem Ordner vom Typ "Daily".

Inspizieren

Inspektionsbefehle für Baumansichten, Suche, Verknüpfungen, Synchronisationsereignisse und Live-Knotenausrichtung.

Befehl	Beschreibung
show	Zeigt den neuesten Backup-Baum für ein Dokument an.
search	Durchsucht die neuesten Backups nach passendem Knotentext oder Notizinhalt.
changes	Analysiert aktuelle Client-Sync-Änderungsereignisse aus lokalen Protokollen.
links	Extrahiert ausgehende Mubu-Dokumentlinks aus einem Dokumentsicherungsstand.
open-path	Öffnet ein Dokument über den vollständigen Pfad, Teilpfad, Titel oder die Dokument-ID.
doc-nodes	Listet Live-Dokumentknoten mit Knoten-IDs und Update-Zielpfaden auf.
daily-nodes	Listet Live-Knoten aus dem aktuellen täglichen Dokument in einem Schritt auf.

Mutieren

Mutationsbefehle für atomare Live-Bearbeitungen gegen die Mubu-API (standardmäßig Trockenlauf).

Befehl	Beschreibung
create-child	Erstellt oder führt eine Kindknoten-Erstellung gegen die Live-Mubu-API aus.
delete-node	Erstellt oder führt eine Knotenlöschung gegen die Live-Mubu-API aus.
update-text	Erstellt oder führt eine Textaktualisierung gegen die Live-Mubu-API aus.

Sitzung

Sitzungs- und Zustandsbefehle für den aktuellen Dokument-/Knotenkontext und den lokalen Befehlsverlauf.

Befehl	Beschreibung
status	Zeigt den aktuellen Sitzungszustand an.
state-path	Zeigt den Dateipfad des Sitzungszustands an.
use-doc	Speichert die aktuelle Dokumentreferenz dauerhaft.
use-node	Speichert die aktuelle Knotenreferenz dauerhaft.
use-daily	Ermittelt und speichert die aktuelle tägliche Dokumentreferenz dauerhaft.
clear-doc	Löscht die aktuelle Dokumentreferenz.
clear-node	Löscht die aktuelle Knotenreferenz.
history	Zeigt den kürzlichen Befehlsverlauf aus dem Sitzungszustand an.

Empfohlener Agenten-Workflow

entdecken daily-current '<daily-folder-ref>' --json
        ->
inspektoren daily-nodes '<daily-folder-ref>' --query '<anchor>' --json
        ->
sitzung use-doc '<doc_path>'
        ->
mutieren update-text / create-child / delete-node --json
        ->
--execute erst nach Payload-Inspektion

Sicherheitsregeln

1. Für den Agenteneinsatz bevorzugt gruppierte Befehle verwenden; flache Legacy-Befehle bleiben aus Kompatibilitätsgründen erhalten.
2. Verwenden Sie --json, wenn ein Agent die Ausgabe parsen wird.
3. Vor einem mutate-Befehl bevorzugt discover- oder inspect-Befehle ausführen.
4. Live-Mutationen sind standardmäßig Trockenläufe und werden nur mit --execute ausgeführt.
5. Bevorzugen Sie --node-id und --parent-node-id gegenüber Textabgleich.
6. delete-node entfernt den gesamten Zielunterbaum.
7. Selbst Textaktualisierungen mit gleichem Text können den Dokumentversionsverlauf fortschreiten lassen.
8. Übergeben Sie eine tägliche Ordnerreferenz explizit oder setzen Sie MUBU_DAILY_FOLDER, bevor Sie die täglichen Helfer ohne Argumente verwenden.

Beispiele

Interaktive REPL-Sitzung

Starten Sie eine interaktive Sitzung mit persistentem Dokument- und Knotenkontext.

cli-anything-mubu
# Befehle interaktiv eingeben
# 'help' eingeben, um eingebaute Befehle zu sehen
# Sitzungsbefehle verwenden, um current-doc/current-node dauerhaft zu speichern

Aktuelle tägliche Notiz entdecken

Ermitteln Sie die aktuelle tägliche Notiz aus einer expliziten Ordnerreferenz.

cli-anything-mubu --json discover daily-current '<daily-folder-ref>'

Atomares Update im Trockenlauf

Inspizieren Sie die genaue ausgehende Nutzlast vor einer Live-Mutation.

cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'neuer text' --json

Sitzungszustand

Die CLI verwaltet einen leichten Sitzungszustand im JSON-Format:

• current_doc
• current_node
• lokaler Befehlsverlauf

Verwenden Sie die session-Befehlsgruppe, um diesen Zustand zu inspizieren oder zu aktualisieren.

Für KI-Agenten

1. Beginnen Sie mit discover oder inspect, nicht mit mutate.
2. Verwenden Sie session status --json, um den gespeicherten Kontext wiederherzustellen.
3. Verwenden Sie gruppierte Befehle in generierten Aufforderungen und Automatisierungen.
4. Überprüfen Sie die Nachbedingungen nach jeder Live-Mutation.
5. Lesen Sie die Dateien TEST.md und README.md des Pakets, wenn strengere operative Details erforderlich sind.

Version

0.1.1