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.