Name: LystBot
Author: TourAround

🚀 시작하기

1. 앱 설치

앱을 열고 첫 번째 목록을 만든 다음, 설정 → AI 에이전트에서 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은 그 AI가 제어하는 앱일 뿐입니다.

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와 작동합니다. 연결 방법은 다음과 같습니다:

개인 에이전트 및 자율 프레임워크

에이전트	제공자	통합 방식
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를 통한 버그 리포트 및 기능 요청
🔧 CLI 개선 및 새로운 명령어 추가
📖 문서 수정

포크하고, 브랜치를 만들고, PR을 보내주세요.

📄 라이선스

MIT - 자세한 내용은 LICENSE를 참조하세요.

TourAround UG에서 ❤️를 담아 제작

LystBot