Name: LystBot
Author: TourAround

🚀 Начало работы

1. Установите приложение

Откройте приложение, создайте свой первый список и получите API-ключ в разделе Настройки → ИИ-агенты.

2. Подключите своего ИИ-агента

Перейдите на страницу настройки агента для получения пошаговых инструкций:

👉 lystbot.com/agents

Три способа подключения в зависимости от вашей системы:

Метод	Лучше всего подходит для	Время настройки
CLI	OpenClaw, персональные агенты, скрипты, автоматизация	1 мин
MCP-сервер	Claude Desktop, Cursor, Windsurf, Cline	2 мин
REST API	ChatGPT Actions, кастомные агенты, Home Assistant	5 мин

3. Вот и все

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

Ваш агент добавляет пункты. Ваш телефон мгновенно обновляется. Готово.

🧠 Как это работает

Большинство «приложений со списками на базе ИИ» встраивают чат-бота внутрь приложения. LystBot делает наоборот: ваш ИИ живет там, где он уже живет, а LystBot — это приложение, которым он управляет.

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

Не нужно изучать новый ИИ. Никаких промптов внутри приложения. Просто подключите существующий ИИ, и он будет управлять вашими покупками, списками вещей, задачами — чем угодно.

🤖 «Добавь яйца в мой список покупок» действительно работает — с любым ИИ, которым вы уже пользуетесь
📱 Ваш телефон — это дисплей — ваш ИИ пишет, вы видите это мгновенно
🔑 Четкое разделение — приложение для людей, API для агентов
🔄 Синхронизация в реальном времени — ваш ИИ добавляет молоко, ваш партнер видит это немедленно

✨ Функции

🗒️ Умные списки — Создавайте, организуйте и делитесь списками с кем угодно

🤝 Общий доступ в реальном времени — Приглашайте других с помощью кодов доступа, работайте совместно в прямом эфире

📱 Кроссплатформенность — iOS и Android, с доступом через CLI и API

⭐ Избранное — Быстрый доступ к пунктам, которые вы используете постоянно

🗂️ Категории — Структурируйте списки по разделам, перемещайте пункты между категориями, храните нераспределенные пункты в разделе «Другое»

🔔 Push-уведомления — Знайте, когда ваш ИИ или ваша семья меняют список

🌐 Открытый API — Полноценный REST API, чтобы любой ИИ-агент мог читать, записывать, управлять и классифицировать ваши списки

🤖 Интеграции с агентами

LystBot работает с любым ИИ, который может выполнять HTTP-запросы. Вот как подключить ваш:

Персональные агенты и автономные фреймворки

Агент	Провайдер	Интеграция
OpenClaw	OpenClaw	CLI (`npx lystbot`)
Devin	Cognition AI	CLI или REST API
Aider	Open Source	CLI
OpenCode	Open Source	CLI или MCP-сервер
AutoGPT	Open Source	REST API
CrewAI	Open Source	REST API
Manus AI	Manus	REST API

Агенты для программирования и IDE

Агент	Провайдер	Интеграция
Claude Desktop	Anthropic	MCP-сервер (настройка ниже)
Claude Code	Anthropic	MCP-сервер (настройка ниже)
Cursor	Anysphere	MCP-сервер
Windsurf	Codeium	MCP-сервер
GitHub Copilot	Microsoft	MCP-сервер или расширение Copilot
Cline	Open Source	MCP-сервер

Голосовые помощники и чат-ИИ

Агент	Провайдер	Интеграция
ChatGPT	OpenAI	Custom GPT с OpenAPI Actions
Google Gemini	Google	Расширения Gemini через REST API
Microsoft Copilot	Microsoft	Плагин Copilot с OpenAPI
Grok	xAI	REST API
Siri / Apple Intelligence	Apple	Команды Apple (Shortcuts) с REST API
Amazon Alexa	Amazon	Кастомный навык Alexa с REST API
Google Home	Google	Google Actions с REST API

Не видите своего агента? Если он может вызывать API, он может использовать LystBot. Проверьте документацию API.

💻 CLI

LystBot CLI позволяет управлять списками из терминала. Создан для ИИ-агентов, таких как OpenClaw, которые лучше всего работают с инструментами командной строки, и для всех, кто любит автоматизировать процессы.

Установка и вход

npx lystbot login <YOUR_API_KEY>

Команды

# 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

Полная справка: документация CLI

🔌 MCP-сервер

LystBot поставляется со встроенным MCP сервером. Работает с Claude Desktop, Claude Code, Cursor, Windsurf, Cline и любым клиентом, совместимым с MCP.

Сначала пройдите аутентификацию (это нужно для всех настроек):

npx lystbot login <YOUR_API_KEY>

Claude Desktop

Добавьте это в свой конфигурационный файл:

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

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

Перезапустите Claude Desktop. Готово.

Claude Code

Одна команда:

claude mcp add lystbot -- npx lystbot mcp

Вот и все. Теперь Claude Code может управлять вашими списками.

Cursor / Windsurf / Cline

Добавьте ту же конфигурацию в настройки MCP вашего редактора:

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

Доступные инструменты

Инструмент	Описание
`list_lists`	Получить все ваши списки
`get_list`	Получить конкретный список с пунктами
`create_list`	Создать новый список
`delete_list`	Удалить список
`add_items`	Добавить один или несколько пунктов в список
`check_item`	Отметить пункт как выполненный
`uncheck_item`	Снять отметку с пункта
`remove_item`	Удалить пункт из списка
`clear_checked`	Удалить все отмеченные (выполненные) пункты из списка
`share_list`	Сгенерировать код доступа для списка
`join_list`	Присоединиться к общему списку по коду
`list_categories`	Список категорий для списка
`create_category`	Создать категорию
`rename_category`	Переименовать категорию
`delete_category`	Удалить категорию
`reorder_categories`	Изменить порядок категорий
`move_item`	Переместить пункт в категорию (или в «Другое»)

🏗️ Архитектура

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

📚 Документация

📡 Справочник API - Полная документация эндпоинтов с примерами curl
💻 Справочник CLI - Все команды и флаги
🔌 MCP-сервер - npx lystbot mcp (см. настройку выше)

🤝 Участие в разработке

Мы будем рады вашей помощи! Будь то:

🐛 Отчеты об ошибках и запросы функций через Issues
🔧 Улучшения CLI и новые команды
📖 Исправления в документации

Делайте форк, создавайте ветку, отправляйте PR.

📄 Лицензия

MIT - подробности см. в LICENSE.

Создано с ❤️ компанией TourAround UG

LystBot