mcpField
O
openwork-debug

openwork-debug

github.com/different-ai開発24.3k95 回インストール今日更新
リポジトリ

openwork-debug について

OpenWork と OpenCode エンジンを調査する読み取り専用のデバッグスキルです。HTTP チェック、ワークスペースや監査ログの確認、エンジン診断、SQLite による代替クエリを行えます。

主な機能

  1. 01サーバーの状態と機能を確認
  2. 02ワークスペースと設定を調査
  3. 03最近の監査ログを確認
  4. 04OpenCode エンジンを診断
  5. 05代替手段として SQLite を照会

活用シーン

  1. 01OpenWork サーバーの応答を診断
  2. 02ワークスペース設定と活動を調査
  3. 03OpenCode と MCP の状態を確認
  4. 04エンジン API が使えない場合に最近のセッションを確認

MCP 対応

設定済み MCP サーバーの一覧表示とデバッグに使う OpenCode コマンドが含まれます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/different-ai/openwork --skill openwork-debug

インストール後、Claude Code で/openwork-debugを入力して読み込まれたか確認します。

詳細

認証情報の確認

HTTP チェックを実行する前に、以下を設定してください。

  • OPENWORK_SERVER_URL
  • OPENWORK_SERVER_TOKEN
  • OPENWORK_WORKSPACE_ID（任意。確認するには /workspaces を使用してください）

クイック使用方法（読み取り専用）

curl -s "$OPENWORK_SERVER_URL/health"
curl -s "$OPENWORK_SERVER_URL/capabilities" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

curl -s "$OPENWORK_SERVER_URL/workspaces" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

ワークスペース設定のスナップショット

curl -s "$OPENWORK_SERVER_URL/workspace/$OPENWORK_WORKSPACE_ID/config" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

監査ログ（最近のもの）

curl -s "$OPENWORK_SERVER_URL/workspace/$OPENWORK_WORKSPACE_ID/audit?limit=25" \
  -H "Authorization: Bearer $OPENWORK_SERVER_TOKEN"

OpenCode エンジンのチェック

opencode -p "ping" -f json -q
opencode mcp list
opencode mcp debug <name>

DB フォールバック（読み取り専用）

エンジン API を利用できない場合は、SQLite データベースを確認できます。

sqlite3 ~/.opencode/opencode.db "select id, title, status from sessions order by updated_at desc limit 5;"
sqlite3 ~/.opencode/opencode.db "select role, content from messages order by created_at desc limit 10;"

注意事項

  • 監査ログは、ワークスペースのルートにある .opencode/openwork/audit.jsonl に保存されます。
  • OpenWork サーバーは、承認されたワークスペースのルート内のみで書き込みを行います。

コメント

Markdown 対応