Name: LystBot
Author: TourAround

🚀 Erste Schritte

1. Holen Sie sich die App

Öffnen Sie die App, erstellen Sie Ihre erste Liste und holen Sie sich Ihren API-Schlüssel unter Einstellungen → KI-Agenten.

2. Verbinden Sie Ihren KI-Agenten

Besuchen Sie die Einrichtungsseite für Agenten für eine Schritt-für-Schritt-Anleitung:

👉 lystbot.com/agents

Drei Möglichkeiten zur Verbindung, je nach Ihrem Setup:

Methode	Am besten geeignet für	Einrichtungszeit
CLI	OpenClaw, persönliche Agenten, Skripte, Automatisierung	1 Min
MCP-Server	Claude Desktop, Cursor, Windsurf, Cline	2 Min
REST-API	ChatGPT Actions, benutzerdefinierte Agenten, Home Assistant	5 Min

3. Das war's

npx lystbot login YOUR_API_KEY
lystbot add "Groceries" "Oat milk, Bananas, Coffee"

Ihr Agent fügt Elemente hinzu. Ihr Telefon aktualisiert sich sofort. Fertig.

🧠 Funktionsweise

Die meisten „KI-Listen-Apps“ stecken einen Chatbot in die App. LystBot macht das Gegenteil: Ihre KI lebt dort, wo sie bereits lebt, und LystBot ist die App, die sie steuert.

You → talk to your AI → AI calls LystBot API → your phone updates instantly

Keine neue KI zum Lernen. Keine Prompts innerhalb der App. Verbinden Sie einfach Ihre bestehende KI und sie verwaltet Ihre Einkäufe, Packlisten, To-dos – einfach alles.

🤖 „Füge Eier zu meiner Einkaufsliste hinzu“ funktioniert tatsächlich – von jeder KI, die Sie bereits verwenden
📱 Ihr Telefon ist das Display – Ihre KI schreibt, Sie sehen es sofort
🔑 Klare Trennung – die App ist für Menschen, die API ist für Agenten
🔄 Echtzeit-Synchronisierung – Ihre KI fügt Milch hinzu, Ihr Partner sieht es sofort

✨ Funktionen

🗒️ Intelligente Listen – Erstellen, organisieren und teilen Sie Listen mit jedem

🤝 Echtzeit-Teilen – Laden Sie andere über Freigabecodes ein, arbeiten Sie live zusammen

📱 Plattformübergreifend – iOS und Android, mit CLI- und API-Zugriff

⭐ Favoriten – Schneller Zugriff auf Elemente, die Sie ständig verwenden

🗂️ Kategorien – Strukturieren Sie Listen in Abschnitte, verschieben Sie Elemente zwischen Kategorien, behalten Sie nicht kategorisierte Elemente unter Sonstiges

🔔 Push-Benachrichtigungen – Wissen Sie, wann Ihre KI oder Ihre Familie eine Liste ändert

🌐 Offene API – Vollständige REST-API, damit jeder KI-Agent Ihre Listen lesen, schreiben, verwalten und kategorisieren kann

🤖 Agenten-Integrationen

LystBot funktioniert mit jeder KI, die HTTP-Anfragen stellen kann. So verbinden Sie Ihre:

Persönliche Agenten & Autonome Frameworks

Agent	Anbieter	Integration
OpenClaw	OpenClaw	CLI (`npx lystbot`)
Devin	Cognition AI	CLI oder REST-API
Aider	Open Source	CLI
OpenCode	Open Source	CLI oder MCP-Server
AutoGPT	Open Source	REST-API
CrewAI	Open Source	REST-API
Manus AI	Manus	REST-API

Coding-Agenten & IDEs

Agent	Anbieter	Integration
Claude Desktop	Anthropic	MCP-Server (Einrichtung unten)
Claude Code	Anthropic	MCP-Server (Einrichtung unten)
Cursor	Anysphere	MCP-Server
Windsurf	Codeium	MCP-Server
GitHub Copilot	Microsoft	MCP-Server oder Copilot-Erweiterung
Cline	Open Source	MCP-Server

Sprachassistenten & Chat-KI

Agent	Anbieter	Integration
ChatGPT	OpenAI	Custom GPT mit OpenAPI-Actions
Google Gemini	Google	Gemini-Erweiterungen via REST-API
Microsoft Copilot	Microsoft	Copilot-Plugin mit OpenAPI
Grok	xAI	REST-API
Siri / Apple Intelligence	Apple	Apple Kurzbefehle mit REST-API
Amazon Alexa	Amazon	Benutzerdefinierter Alexa-Skill mit REST-API
Google Home	Google	Google Actions mit REST-API

Ihr Agent ist nicht dabei? Wenn er eine API aufrufen kann, kann er LystBot verwenden. Prüfen Sie die API-Dokumentation.

💻 CLI

Mit der LystBot-CLI können Sie Listen über das Terminal verwalten. Entwickelt für KI-Agenten wie OpenClaw, die am besten mit Befehlszeilentools funktionieren, und für alle, die gerne Dinge skripten.

Installieren & Anmelden

npx lystbot login <YOUR_API_KEY>

Befehle

# Lists
lystbot lists                              # Show all lists
lystbot show "Groceries"                   # Show a list with items
lystbot create "Packing List" --emoji "🧳" # Create a new list
lystbot delete "Old List" --force          # Delete a list

# Items
lystbot add "Groceries" "Milk, Eggs, Bread"  # Add items (comma-separated)
lystbot check "Groceries" "Milk"             # Check off an item
lystbot uncheck "Groceries" "Milk"           # Uncheck an item
lystbot remove "Groceries" "Milk"            # Remove an item

# Categories
lystbot categories "Groceries"                 # List categories (incl. Other)
lystbot category add "Groceries" "Fruits"      # Create a category
lystbot add "Groceries" "Bananas" --category "Fruits"   # Add into a category
lystbot move "Groceries" "Bananas" --category other      # Move to Other/uncategorized

# Sharing
lystbot share "Groceries"                  # Generate a share code
lystbot join ABC123                        # Join a shared list

# Agent identity
lystbot profile --name "TARS" --emoji "🤖" # Set your bot's display name

Vollständige Referenz: CLI-Dokumentation

🔌 MCP-Server

LystBot wird mit einem integrierten MCP-Server geliefert. Funktioniert mit Claude Desktop, Claude Code, Cursor, Windsurf, Cline und jedem MCP-kompatiblen Client.

Zuerst authentifizieren (alle Setups benötigen dies):

npx lystbot login <YOUR_API_KEY>

Claude Desktop

Fügen Sie dies Ihrer Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lystbot": {
      "command": "npx",
      "args": ["lystbot", "mcp"]
    }
  }
}

Starten Sie Claude Desktop neu. Fertig.

Claude Code

Ein Befehl:

claude mcp add lystbot -- npx lystbot mcp

Das war's. Claude Code kann jetzt Ihre Listen verwalten.

Cursor / Windsurf / Cline

Fügen Sie dieselbe Konfiguration zu den MCP-Einstellungen Ihres Editors hinzu:

{
  "mcpServers": {
    "lystbot": {
      "command": "npx",
      "args": ["lystbot", "mcp"]
    }
  }
}

Verfügbare Tools

Tool	Beschreibung
`list_lists`	Alle Ihre Listen abrufen
`get_list`	Eine bestimmte Liste mit Elementen abrufen
`create_list`	Eine neue Liste erstellen
`delete_list`	Eine Liste löschen
`add_items`	Ein oder mehrere Elemente zu einer Liste hinzufügen
`check_item`	Ein Element abhaken
`uncheck_item`	Ein Element wieder abhaken
`remove_item`	Ein Element aus einer Liste entfernen
`clear_checked`	Alle abgehakten (erledigten) Elemente aus einer Liste entfernen
`share_list`	Einen Freigabecode für eine Liste generieren
`join_list`	Einer geteilten Liste per Code beitreten
`list_categories`	Kategorien für eine Liste auflisten
`create_category`	Eine Kategorie erstellen
`rename_category`	Eine Kategorie umbenennen
`delete_category`	Eine Kategorie löschen
`reorder_categories`	Kategorien neu anordnen
`move_item`	Ein Element in eine Kategorie (oder Sonstiges) verschieben

🏗️ Architektur

┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  Your Phone  │  │   Your AI    │  │  MCP Client  │  │     CLI      │
│  (LystBot    │  │  (OpenClaw,  │  │  (Claude,    │  │  (npx        │
│   App)       │  │   ChatGPT)   │  │   Cursor)    │  │   lystbot)   │
└──────┬───────┘  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘
       │                 │                 │                 │
       │ X-Device-UUID   │ Bearer Token    │ MCP Protocol    │ Bearer Token
       │                 │                 │                 │
       └────────┬────────┴────────┬────────┴────────┬────────┘
                │                 │                 │
         ┌──────▼─────────────────▼─────────────────▼──────┐
         │               LystBot API                       │
         │            (REST/JSON + MCP)                     │
         └─────────────────────────────────────────────────┘

📚 Dokumentation

📡 API-Referenz - Vollständige Endpunkt-Dokumentation mit curl-Beispielen
💻 CLI-Referenz - Alle Befehle und Flags
🔌 MCP-Server - npx lystbot mcp (siehe Einrichtung oben)

🤝 Mitwirken

Wir freuen uns über Ihre Hilfe! Egal ob:

🐛 Fehlerberichte und Funktionsanfragen über Issues
🔧 CLI-Verbesserungen und neue Befehle
📖 Dokumentationskorrekturen

Forken Sie es, erstellen Sie einen Branch, senden Sie einen PR.

📄 Lizenz

MIT - siehe LICENSE für Details.

Mit ❤️ erstellt von TourAround UG

LystBot