dacrypt/xiao

xiao CLI を使って Xiaomi ロボット掃除機 X20+ を制御します。AGENTS.md、llms.txt、SKILL.md、--json 出力、正規の終了コードを備えたエージェント対応スキルです。

xiao とは?

dacrypt/xiao は、Xiaomi ロボット掃除機 X20+ をコマンドラインから制御するためのスキルです。AI エージェント(Claude Code、Cursor、Codex など)との連携を念頭に設計されており、AGENTS.md、llms.txt、SKILL.md といったエージェント向けドキュメントを提供します。xiao CLI は --json オプションによる構造化出力と正規の終了コードをサポートしているため、スクリプトや AI エージェントからの利用が容易です。このスキルにより、エージェントは掃除の開始・停止、充電ステーションへの帰還、スケジュール設定、マッピング情報の取得など、ロボット掃除機の主要機能をプログラムから操作できるようになります。Linux、macOS、Windows の主要プラットフォームで動作し、Homebrew や npm などのパッケージマネージャー、または直接バイナリダウンロードで簡単にインストールできます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add dacrypt/xiao

Installed? Explore more 生産性&コラボレーション skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

xiao は何をしますか?

xiao CLI を使って Xiaomi ロボット掃除機 X20+ を制御します。エージェント対応: AGENTS.md、llms.txt、SKILL.md、--json 出力、正規の終了コード。

概要

xiao は、Xiaomi ロボット掃除機 X20+ をコマンドラインから操作するためのツールです。

インストール

Homebrew(macOS / Linux)

brew tap dacrypt/xiao
brew install xiao

npm

npm install -g @dacrypt/xiao

直接ダウンロード

Releases ページからプラットフォームに合ったバイナリをダウンロードしてください。

使い方

基本的なコマンド

# 掃除を開始
xiao start

# 掃除を停止
xiao stop

# 充電ステーションに戻る
xiao home

# ステータスを確認
xiao status

JSON 出力

すべてのコマンドで --json フラグを使用すると、機械可読な JSON 形式で出力されます。

xiao status --json

エージェントモード

# エージェント向けドキュメントを表示
xiao agent --help

設定

環境変数 XIAO_TOKEN または設定ファイルでアクセストークンを設定します。

export XIAO_TOKEN="your_token_here"

エージェント対応

このプロジェクトには以下のエージェント向けファイルが含まれています。

  • AGENTS.md - AI エージェントのための使用ガイド
  • llms.txt - LLM 向けの構造化情報
  • SKILL.md - スキル定義(本ファイル)

終了コード

  • 0: 成功
  • 1: 一般的なエラー
  • 2: 認証エラー
  • 3: ネットワークエラー

ライセンス

MIT

関連スキル