Name: LystBot
Author: TourAround

🚀 入门指南

1. 获取应用

打开应用，创建你的第一个清单，并从 设置 → AI 智能体 (Settings → AI Agents) 获取你的 API 密钥。

2. 连接你的 AI 智能体

前往智能体设置页面查看分步说明：

👉 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"

你的智能体添加项目，你的手机会立即更新。搞定。

🧠 工作原理

大多数“AI 清单应用”将聊天机器人塞进应用里。LystBot 则相反：你的 AI 运行在它原本运行的地方，而 LystBot 是它所控制的应用。

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

无需学习新的 AI，应用内也没有提示词。只需连接你现有的 AI，它就能管理你的购物、打包清单、待办事项——任何内容。

🤖 “把鸡蛋加到我的购物清单里”真的有效 - 来自你正在使用的任何 AI
📱 你的手机就是显示屏 - 你的 AI 写入，你立即看到
🔑 清晰的分离 - 应用是给人类用的，API 是给智能体用的
🔄 实时同步 - 你的 AI 添加了牛奶，你的伴侣会立即看到

✨ 功能

🗒️ 智能清单 - 创建、组织并与任何人共享清单

🤝 实时共享 - 通过共享代码邀请他人，实时协作

📱 跨平台 - iOS 和 Android，支持 CLI 和 API 访问

⭐ 收藏夹 - 快速访问你经常使用的项目

🗂️ 分类 - 将清单结构化为多个部分，在类别间移动项目，将未分类的项目保留在“其他”中

🔔 推送通知 - 当你的 AI 或家人更改清单时及时获知

🌐 开放 API - 完整的 REST API，任何 AI 智能体都可以读取、写入、管理和分类你的清单

🤖 智能体集成

LystBot 适用于任何可以发起 HTTP 请求的 AI。以下是如何连接你的 AI：

个人智能体与自主框架

智能体	提供商	集成方式
OpenClaw	OpenClaw	CLI (`npx lystbot`)
Devin	Cognition AI	CLI 或 REST API
Aider	开源	CLI
OpenCode	开源	CLI 或 MCP 服务器
AutoGPT	开源	REST API
CrewAI	开源	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	开源	MCP 服务器

语音助手与聊天 AI

智能体	提供商	集成方式
ChatGPT	OpenAI	带有 OpenAPI Actions 的自定义 GPT
Google Gemini	Google	通过 REST API 的 Gemini 扩展
Microsoft Copilot	Microsoft	带有 OpenAPI 的 Copilot 插件
Grok	xAI	REST API
Siri / Apple Intelligence	Apple	带有 REST API 的 Apple 快捷指令
Amazon Alexa	Amazon	带有 REST API 的自定义 Alexa 技能
Google Home	Google	带有 REST API 的 Google Actions

没看到你的智能体？只要它能调用 API，它就能使用 LystBot。查看 API 文档。

💻 CLI

LystBot CLI 允许你从终端管理清单。专为像 OpenClaw 这样最适合命令行工具的 AI 智能体而构建，也适合任何喜欢脚本化操作的用户。

安装与登录

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 报告 Bug 和功能请求
🔧 CLI 改进和新命令
📖 文档修复

Fork 它，创建分支，提交 PR。

📄 许可证

MIT - 详情请参阅 LICENSE。

由 TourAround UG 用 ❤️ 构建

LystBot