Name: LystBot
Author: TourAround

🚀 はじめに

1. アプリを入手する

アプリを開いて最初のリストを作成し、設定 → AIエージェントからAPIキーを取得してください。

2. AIエージェントを接続する

エージェント設定ページでステップバイステップの手順を確認してください：

👉 lystbot.com/agents

セットアップに応じて、以下の3つの接続方法があります：

方法	用途	セットアップ時間
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はそのAIが制御するアプリとなります。

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

新しいAIを学習する必要も、アプリ内でプロンプトを入力する必要もありません。既存のAIを接続するだけで、買い物リスト、パッキングリスト、ToDoなど、あらゆるリストを管理できます。

🤖 「買い物リストに卵を追加して」が実際に機能します - 既に使用しているあらゆるAIから
📱 スマホがディスプレイになります - AIが書き込み、あなたは即座に確認できます
🔑 明確な分離 - アプリは人間用、APIはエージェント用です
🔄 リアルタイム同期 - AIが牛乳を追加すれば、パートナーの端末にも即座に反映されます

✨ 機能

🗒️ スマートリスト - リストの作成、整理、誰とでも共有が可能

🤝 リアルタイム共有 - 共有コードで招待し、ライブで共同編集

📱 クロスプラットフォーム - iOSおよびAndroid対応、CLIおよびAPIアクセスも可能

⭐ お気に入り - よく使うアイテムへのクイックアクセス

🗂️ カテゴリ - リストをセクション分けし、アイテムをカテゴリ間で移動。未分類のアイテムは「その他」に保持

🔔 プッシュ通知 - AIや家族がリストを変更した際に通知を受け取る

🌐 オープンAPI - 完全なREST APIにより、あらゆるAIエージェントがリストの読み取り、書き込み、管理、カテゴリ分けを行えます

🤖 エージェント統合

LystBotは、HTTPリクエストを行えるあらゆる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アクション

お使いのエージェントが見当たりませんか？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`	リストに1つ以上のアイテムを追加
`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を参照してください。

Built with ❤️ by TourAround UG

LystBot