falkoro/shelldeck

shelldeck は何をしますか？

セルフホスト型のWebダッシュボードで、tmuxセッションやAIコーディングエージェント（Claude Code、Codexなど）を監視・操作できます。ライブプレビュー、実行中/待機中ステータス、AI作業サマリー、ブラウザ内ターミナルを備えています。

概要

Shelldeckを使用すると、複数のAIコーディングエージェントを同時に管理・監視できます。各エージェントはtmuxセッション内で独立して実行され、ブラウザ上の直感的なダッシュボードからすべてを確認できます。

主な機能

• AIエージェントのモニタリング: Claude Code、Codex、その他のAIエージェントのステータスをリアルタイムで表示
• ブラウザ内ターミナル: Webブラウザから直接、各tmuxセッションにアクセスして操作可能
• ライブプレビュー: 実行中のジョブの出力をリアルタイムで確認
• AI作業サマリー: 各エージェントの作業内容を自動要約
• 複数セッション管理: 複数のプロジェクトやエージェントを同時に監視

クイックスタート

# リポジトリをクローン
git clone https://github.com/falkoro/shelldeck.git
cd shelldeck

# 依存関係をインストール
npm install

# サーバーを起動
npm start

ダッシュボードは http://localhost:3000 でアクセスできます。

使用方法

1. ダッシュボードにアクセスすると、既存のtmuxセッション一覧が表示されます
2. 「新規セッション」ボタンをクリックして、新しいAIエージェントセッションを開始
3. 各セッションカードには、ステータス、実行時間、最後の出力が表示されます
4. 「ターミナル」ボタンをクリックすると、ブラウザ内で直接セッションにアクセス
5. 設定画面から、監視するエージェントの種類や表示設定をカスタマイズ

設定

環境変数または config.json で設定を行います：

{
  "port": 3000,
  "sessionPrefix": "ai-",
  "autoStart": true,
  "agentConfigs": [
    {
      "name": "Claude Code",
      "command": "claude",
      "color": "#6366f1"
    },
    {
      "name": "Codex",
      "command": "codex",
      "color": "#22c55e"
    }
  ]
}

対応AIエージェント

• Claude Code - AnthropicのAIコーディングエージェント
• Codex CLI - OpenAIのコード生成エージェント
• その他、tmuxセッション内で実行可能な任意のコマンド

ライセンス

MIT