mcpField
O
openwork-debug

openwork-debug

github.com/different-aiDevelopment24.3k95 installsUpdated today
Repository

About openwork-debug

A read-only debugging skill for OpenWork and its OpenCode engine. It provides HTTP checks, workspace and audit inspection, engine diagnostics, and SQLite fallback queries.

Key features

  1. 01Check server health and capabilities
  2. 02Inspect workspaces and configuration
  3. 03Review recent audit logs
  4. 04Run OpenCode engine checks
  5. 05Query SQLite as a fallback

Use cases

  1. 01Diagnose OpenWork server responses
  2. 02Inspect workspace settings and activity
  3. 03Check OpenCode and MCP status
  4. 04Review recent sessions when the engine API is unavailable

MCP support

Includes OpenCode commands to list and debug configured MCP servers.

Install

Copy the command and run it in a terminal.

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

After installing, type/openwork-debugin Claude Code to confirm it loaded.

Details

From the project README

Credential check

Set these before running the HTTP checks:

  • OPENWORK_SERVER_URL
  • OPENWORK_SERVER_TOKEN
  • OPENWORK_WORKSPACE_ID (optional; use /workspaces to discover)

Quick usage (read-only)

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"

Workspace config snapshot

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

Audit log (recent)

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

OpenCode engine checks

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

DB fallback (read-only)

When the engine API is unavailable, you can inspect the SQLite db:

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;"

Notes

  • Audit logs are stored at .opencode/openwork/audit.jsonl in the workspace root.
  • OpenWork server writes only within approved workspace roots.

Comments

Markdown supported