LystBot

🚀 Primeros pasos

1. Obtén la aplicación

Abre la aplicación, crea tu primera lista y obtén tu clave API en Ajustes → Agentes de IA.

2. Conecta tu agente de IA

Dirígete a la página de configuración del agente para obtener instrucciones paso a paso:

👉 lystbot.com/agents

Tres formas de conectar, dependiendo de tu configuración:

3. Eso es todo

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

Tu agente añade elementos. Tu teléfono se actualiza al instante. Listo.

🧠 Cómo funciona

La mayoría de las "aplicaciones de listas con IA" meten un chatbot dentro de la aplicación. LystBot hace lo contrario: tu IA vive donde ya vive, y LystBot es la aplicación que controla.

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

No hay nueva IA que aprender. No hay prompts dentro de la aplicación. Solo conecta tu IA existente y gestionará tus compras, listas de equipaje, tareas pendientes... cualquier cosa.

• 🤖 "Añade huevos a mi lista de la compra" realmente funciona - desde cualquier IA que ya utilices

• 📱 Tu teléfono es la pantalla - tu IA escribe, tú lo ves al instante

• 🔑 Separación clara - la aplicación es para humanos, la API es para agentes

• 🔄 Sincronización en tiempo real - tu IA añade leche, tu pareja lo ve inmediatamente

✨ Características

🗒️ Listas inteligentes - Crea, organiza y comparte listas con cualquier persona

🤝 Compartir en tiempo real - Invita a otros mediante códigos de invitación, colabora en vivo

📱 Multiplataforma - iOS y Android, con acceso CLI y API

⭐ Favoritos - Elementos de acceso rápido que usas todo el tiempo

🗂️ Categorías - Estructura las listas en secciones, mueve elementos entre categorías, mantén los elementos sin categorizar en Otros

🔔 Notificaciones push - Entérate cuando tu IA o tu familia cambien una lista

🌐 API abierta - API REST completa para que cualquier agente de IA pueda leer, escribir, gestionar y categorizar tus listas

🤖 Integraciones de agentes

LystBot funciona con cualquier IA que pueda realizar peticiones HTTP. Aquí te explicamos cómo conectar la tuya:

Agentes personales y marcos autónomos

Agentes de codificación e IDEs

Asistentes de voz e IA de chat

¿No ves tu agente? Si puede llamar a una API, puede usar LystBot. Consulta la documentación de la API.

💻 CLI

La CLI de LystBot te permite gestionar listas desde la terminal. Creada para agentes de IA como OpenClaw que funcionan mejor con herramientas de línea de comandos, y para cualquiera a quien le guste automatizar cosas.

Instalación e inicio de sesión

npx lystbot login <YOUR_API_KEY>

Comandos

# 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

Referencia completa: Documentación de la CLI

🔌 Servidor MCP

LystBot incluye un servidor MCP integrado. Funciona con Claude Desktop, Claude Code, Cursor, Windsurf, Cline y cualquier cliente compatible con MCP.

Primero, autentícate (todas las configuraciones necesitan esto):

npx lystbot login <YOUR_API_KEY>

Claude Desktop

Añade esto a tu archivo de configuración:

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

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

Reinicia Claude Desktop. Listo.

Claude Code

Un comando:

claude mcp add lystbot -- npx lystbot mcp

Eso es todo. Claude Code ahora puede gestionar tus listas.

Cursor / Windsurf / Cline

Añade la misma configuración a los ajustes de MCP de tu editor:

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

Herramientas disponibles

🏗️ Arquitectura

┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐
│  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)                     │
         └─────────────────────────────────────────────────┘

📚 Documentación

• 📡 Referencia de la API - Documentación completa de endpoints con ejemplos curl

• 💻 Referencia de la CLI - Todos los comandos y flags

• 🔌 Servidor MCP - npx lystbot mcp (ver configuración arriba)

🤝 Contribución

¡Nos encantaría contar con tu ayuda! Ya sea:

• 🐛 Informes de errores y solicitudes de funciones a través de Issues

• 🔧 Mejoras en la CLI y nuevos comandos

• 📖 Correcciones en la documentación

Haz un fork, crea una rama y envía un PR.

📄 Licencia

MIT - ver LICENSE para más detalles.

Creado con ❤️ por TourAround UG