Mit TILL starten

Mit deinem Agenten

Füg den Setup-Prompt in einen Agenten ein, der auf deinem Rechner Befehle ausführen kann: Claude Code (im Terminal oder in der Desktop-App), Cursor oder Windsurf. Er prüft Node, installiert TILL, startet das Studio, bittet dich, auf «Demo ausprobieren» zu klicken, und verbindet sich selbst. Lies den Prompt, bevor du ihn einfügst.

Du hilfst mir, TILL einzurichten, eine Schweizer Buchhaltung, die local first auf meinem eigenen Rechner läuft. Mach alles von Anfang bis Ende und erklär jeden Schritt in einfachen Worten.

1. TILL läuft auf macOS und Linux. Prüf mit `node --version`, ob Node.js in Version 22 oder neuer installiert ist. Fehlt es oder ist es älter, installier oder aktualisier es für mein Betriebssystem und bestätige danach die Version.
2. Installier TILL mit `npm install -g tillbooks@beta`.
3. Starte es mit `till up` und lass es laufen. Das Studio öffnet sich unter http://127.0.0.1:8788.
4. Bitte mich, auf der ersten Seite des Studios «Demo ausprobieren» zu wählen, damit wir mit einer Demofirma und Beispieldaten arbeiten und nicht mit echten Büchern.
5. Verbinde dich über MCP mit dem laufenden TILL unter http://127.0.0.1:8788/mcp. Kann dein Client nur stdio, nimm: {"mcpServers":{"tillbooks":{"command":"npx","args":["-y","tillbooks@beta","mcp"]}}} Musst du dafür neu starten, sag es mir.
6. Lies https://github.com/tillbooks/tillbooks/blob/HEAD/AGENTS.md mit den Regeln, nach denen du arbeitest, und zeig mir dann drei Dinge, die du in der Demofirma tun kannst.

Diese Regeln gelten ab dem ersten Schritt, auch bevor du AGENTS.md gelesen hast:
- Arbeite nur in der Demofirma, bis ich etwas anderes sage. Leg nie selbst echte Bücher an, stell keine wieder her und öffne keine.
- Lies, tippe oder speichere nie ein Passwort, ein E-Banking-Login oder einen EBICS-Schlüssel. Die gebe ich selbst ein.
- Standardmässig wartest du auf mein OK, bevor du etwas buchst, Geld bewegst, Zugriff gewährst oder Daten endgültig löschst. Versuch nie, das zu umgehen.

Oder füg nur den MCP-Server hinzu, mit einem Klick

Die Schaltflächen tragen den stdio-Server ein. Willst du auch das Studio, starte daneben till up.

claude mcp add tillbooks -- npx -y tillbooks@beta mcp

{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks@beta",
        "mcp"
      ]
    }
  }
}

Terminal

Du brauchst Node.js 22 oder neuer, auf macOS oder Linux. node --version zeigt dir, welche Version du hast.

Das Studio öffnet sich in deinem Browser unter http://127.0.0.1:8788. Es lauscht nur auf deinem eigenen Rechner.

Die erste Seite fragt, wie du beginnen willst

• Demo ausprobieren

  Eine Demofirma mit Beispielbuchungen, um dich zuerst umzusehen. Du kannst sie später löschen.

• Eigene Bücher anlegen

  Gib den Namen deiner Firma ein, und TILL legt die Buchhaltung mit dem Kontenrahmen KMU an.

• Backup wiederherstellen

  Eine .tillbackup-Datei kommt in einen neuen Arbeitsbereich. Was du schon hast, bleibt unangetastet.

• Bestehende Datenbank übernehmen

  Ein TILL-Hauptbuch, das schon auf diesem Rechner liegt: Du wählst die Datei, und TILL öffnet sie dort, wo sie ist. Kopiert oder verschoben wird sie nie.

In einer Agenten-Sitzung

In einer abgeschotteten Agenten-Sitzung (zum Beispiel einer Claude-Code- oder Cowork-Sitzung in der Cloud) läuft TILL in der Sitzung selbst. Trag den Server mit seinen Büchern in einer Datei im Sitzungsordner ein; der Agent startet ihn, wenn er ihn braucht. Ein Server, den du mitten in der Sitzung einträgst, erscheint in einer neuen Sitzung oder nachdem du MCP neu verbunden hast.

claude mcp add tillbooks -e TILL_DB_PATH="$PWD/till.db" -- npx -y tillbooks@beta mcp

{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks@beta",
        "mcp"
      ],
      "env": {
        "TILL_DB_PATH": "/absolute/path/to/the/session/folder/till.db"
      }
    }
  }
}

Eine Cloud-Sitzung läuft auf dem Rechner des Anbieters, nicht auf deinem, und ihr Ordner wird danach gelöscht. Mach am Ende jeder Sitzung ein Backup und nimm die Datei mit.