agent-virtual-office は何をしますか？
ピクセルアートのバーチャルオフィスで、AIエージェントの活動をリアルタイムに可視化します。Claude Code、Gemini CLI、Codex、およびステータスをPOSTできる任意のツールと連携します。
概要
このプロジェクトは、AIエージェントの活動を視覚的に表現するバーチャルオフィス環境を提供します。各エージェントはオフィス内のピクセルアートキャラクターとして表示され、そのステータス（作業中、待機中、エラーなど）に応じて外見や位置が変化します。
対応ツール
- Claude Code:
claudeコマンド実行時に設定可能 - Gemini CLI:
geminiコマンド実行時に設定可能 - Codex: OpenAI Codex を使用する任意のワークフロー
- その他: HTTP POSTでJSONステータスを送信できる任意のツール
セットアップ
git clone https://github.com/KbWen/agent-virtual-office.git
cd agent-virtual-office
pip install -r requirements.txt
# または npm install
環境変数を設定します:
export VIRTUAL_OFFICE_URL="http://localhost:8080"
export AGENT_NAME="my-agent"
使用方法
エージェントは以下のエンドポイントにPOSTリクエストを送信します:
POST /api/status
Content-Type: application/json
{
"agent": "my-agent",
"status": "working",
"message": "レポートを生成中...",
"timestamp": "2025-04-01T12:00:00Z"
}
ステータス値
| ステータス | 説明 |
|---|---|
working | エージェントがアクティブに作業中 |
idle | エージェントは待機中 |
error | エラーが発生 |
complete | タスクが完了 |
Claude Codeとの統合例
Claude Codeの設定ファイル（~/.claude/settings.json）に以下を追加します:
{
"hooks": {
"onStatusChange": {
"command": "curl -X POST $VIRTUAL_OFFICE_URL/api/status -H 'Content-Type: application/json' -d '{\"agent\": \"claude\", \"status\": \"working\"}'"
}
}
}
ライセンス
MIT