Kommandozeile und MCP

Plandateien im Terminal lesen und bearbeiten oder das einem KI-Assistenten überlassen.

Ein Plan ist eine Datei, und das Werkzeug clearline arbeitet direkt auf dieser Datei. Es ist zugleich ein MCP-Server: Ein KI-Assistent kann einen Plan lesen und ändern.

Das Werkzeug steht noch nicht zum Download bereit. Es wird zusammen mit der App veröffentlicht.

Befehle

clearline read  Keller.clearline              # Plan als Text ausgeben
clearline apply Keller.clearline '<json>'     # Befehle anwenden
clearline apply Keller.clearline -            # Befehle von der Standardeingabe lesen
clearline guide                               # Befehlsreferenz ausgeben
clearline mcp   Keller.clearline              # als MCP-Server über stdio starten

read gibt eine Zusammenfassung aus: jede Wand mit ihrer lichten Länge, die Räume mit ihrer Fläche, Öffnungen mit ihren Abständen, Objekte, Leitungswege und Summen. Sie ist so geschrieben, dass man sich beim Bearbeiten darauf beziehen kann.

apply nimmt ein JSON-Array von Befehlen oder {"commands": [...]}. Der Aufruf ist atomar: Scheitert ein Befehl, bleibt die Datei unverändert, und die Fehlermeldung nennt den Grund. Ist der Plan in der App geöffnet, folgt das Dokument; die Änderung ist ein Widerrufen-Schritt.

Ein Beispiel

clearline apply Bad.clearline '[
  {"op":"room","id":"bad","x":0,"y":0,"width":250,"depth":180,"kind":"drywall"},
  {"op":"opening","id":"tuer","wall":"bad-s","kind":"door","x":60},
  {"op":"fixture","id":"wc","kind":"toilet","wall":"bad-w","y":120},
  {"op":"tap","id":"zapf-wc","x":0,"y":120,"supply":"cold","label":"WC","height":15}
]'

Zahlen stehen in den Einheiten des Plans (Zentimeter, solange nichts anderes eingestellt ist); 240mm oder 4m gehen vor. x zeigt nach rechts, y nach oben. Ein Raum bad erzeugt die Wände bad-s, bad-e, bad-n und bad-w.

Welche Befehle es gibt

Befehl Wirkung
new, set Plan beginnen; Name, Einheiten, Raster, Vorgaben für Wandstärken und Höhe
room Ein rechteckiger Raum aus Innenecke, Breite und Tiefe
partition Eine Wand quer durch den Raum an einem x oder y
wall Eine Wand zwischen zwei Ecken oder Punkten
length Lichte Länge einer Wand setzen und bestimmen, welches Ende wandert
shift, move Eine Wand seitlich verschieben; eine Ecke versetzen
join Zwei Ecken dort verbinden, wo sich ihre Wände kreuzen
opening Eine Tür oder ein Fenster, auch Schiebetüren in der Wand
fixture Ein Objekt aus der Bibliothek, an einer Wand oder frei
run Ein Leitungs- oder Rohrweg
zone Eine Fußbodenheizungszone
tap Eine Zapfstelle
guide Eine Hilfslinie
layer Eine Ebene ein-, ausblenden oder sperren
patch Eine vorhandene Wand, Öffnung, ein Objekt, einen Weg, eine Zone, Zapfstelle oder Hilfslinie ändern
delete Ein Element über seine Kennung entfernen

clearline guide gibt die vollständige Referenz mit jedem Feld aus (auf Englisch).

MCP

Tragen Sie den Server in die MCP-Konfiguration Ihres Assistenten ein, mit dem Pfad des Plans, an dem er arbeiten soll:

{
  "mcpServers": {
    "clearline": {
      "command": "/pfad/zu/clearline",
      "args": ["mcp", "/pfad/zu/Plan.clearline"]
    }
  }
}

Der Server bietet zwei Werkzeuge: read_plan liefert die Zusammenfassung des Plans, apply_plan wendet Befehle an. Bitten Sie den Assistenten um „ein Bad von 2,5 auf 1,8 m in Trockenbau mit der Tür in der Südwand“ und sehen Sie zu, wie es im geöffneten Dokument erscheint.

Der Planinhalt wird an den Assistenten übergeben, den Sie verbinden. Sonst wird nichts irgendwohin gesendet.