xushi は何をしますか?
AIエージェント優先のローカルスケジュール・スケジューリング基盤です。ローカルデーモン、構造化タスク、信頼性の高いリマインダー、補償フォローアップ、OpenClaw/Hermes配信、監査可能な実行ログを提供します。
特徴
- ローカルデーモン: システム起動時に自動起動し、スケジュール管理を常時バックグラウンドで実行
- 構造化タスク: タスクを構造化データ(優先度、期限、依存関係など)として管理
- 信頼性の高いリマインダー: 指定時刻に確実に通知、再試行ロジック内蔵
- 補償フォローアップ: タスク失敗時に自動的に代替アクションや再試行を実行
- OpenClaw/Hermes配信: 分散エージェント間でのイベント配信をサポート
- 監査可能な実行ログ: すべての操作をログとして記録し、後からトレース可能
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他のCUA互換エージェント
インストール
# リポジトリのクローン
git clone https://github.com/polaris-d/xushi.git
cd xushi
# 依存関係のインストール
npm install
# デーモンの起動
npm run daemon:start
使用方法
タスクの作成
xushi task create --title "レポート提出" --deadline "2024-01-15T17:00:00Z" --priority high
リマインダーの設定
xushi reminder set --task-id <task-id> --time "2024-01-15T16:30:00Z"
イベント配信(Hermes経由)
xushi event publish --channel hermes --payload '{"type": "task_completed", "taskId": "<task-id>"}'
設定
環境変数で設定を変更できます。
| 変数名 | 説明 | デフォルト値 |
|---|---|---|
XUSHI_PORT | デーモンのリッスンポート | 4567 |
XUSHI_LOG_LEVEL | ログレベル | info |
XUSHI_DB_PATH | データベースファイルのパス | ./data/xushi.db |
XUSHI_HERMES_ENDPOINT | Hermes配信エンドポイント | http://localhost:8080 |
アーキテクチャ
+-------------------+ +-------------------+ +-------------------+
| AIエージェント | | Polaris-d/xushi | | OpenClaw/Hermes |
| (Claude Code etc) | <-> | ローカルデーモン | <-> | 配信ネットワーク |
+-------------------+ +-------------------+ +-------------------+
|
v
+-------------------+
| SQLite DB |
| (タスク・ログ) |
+-------------------+
ログの監査
xushi log list --since "2024-01-01" --until "2024-01-31"
ライセンス
MIT