Call the local Dessix bridge directly through a line-delimited JSON socket protocol.

Use scripts/dessix-bridge.mjs for all requests instead of re-implementing socket logic.

Workflow

• (Optional) Locate bundled MCP script path dynamically:

node scripts/dessix-bridge.mjs locate-mcp-script

• Verify the bridge is reachable:

node scripts/dessix-bridge.mjs health

• List workspaces:

node scripts/dessix-bridge.mjs invoke \
  --tool dessix_list_workspaces \
  --args '{}'

• Call target tool with JSON args:

node scripts/dessix-bridge.mjs invoke \
  --tool dessix_search_blocks \
  --args '{"query":"MCP","limit":10}'

• Read a Skill prompt from an Action/Scene block:

node scripts/dessix-bridge.mjs invoke \
  --tool dessix_get_skill \
  --args '{"block_id":""}'

Notes

• Start Dessix desktop app first. The bridge is served by the Electron app process.
• To discover bundled MCP script path at runtime, use node scripts/dessix-bridge.mjs locate-mcp-script.

- Override auto-detection with DESSIX_MCP_SCRIPT_PATH (or --mcpScriptPath ). - Current built-in candidates include: - macOS: /Applications/Dessix.app/Contents/Resources/electron/compiled/dessix-mcp.js - Windows: %LOCALAPPDATA%\\Programs\\Dessix\\resources\\electron\\compiled\\dessix-mcp.js

• If DESSIX_MCP_BRIDGE_ENDPOINT is unset, this bridge client uses platform endpoint defaults:

- macOS/Linux: ~/.dessix/mcp/dessix-mcp-bridge.sock - Windows: \\\\.\\pipe\\dessix-mcp-bridge

• Use compact JSON for --args. Invalid JSON fails fast.
• Read references/dessix-tools.md for tool names and argument templates.

Multi-Step Workflows

Combine tools to achieve higher-level goals. Validate outputs before any write.

Skill Discovery

Build a skill map for the current workspace (read-only):

node scripts/dessix-bridge.mjs invoke --tool dessix_get_current_workspace --args '{}'
node scripts/dessix-bridge.mjs invoke --tool dessix_search_blocks --args '{"types":["Action","Scene"],"limit":100}'
# for each block_id in results:
node scripts/dessix-bridge.mjs invoke --tool dessix_get_skill --args '{"block_id":""}'

Topic to Skill Draft

Turn a discussion thread into a reusable Action/Scene block:

node scripts/dessix-bridge.mjs invoke --tool dessix_get_topic_context --args '{"topic_id":""}'
node scripts/dessix-bridge.mjs invoke --tool dessix_search_blocks --args '{"semantic":"related skills and constraints","limit":20}'
# draft title+content from combined context, then:
node scripts/dessix-bridge.mjs invoke --tool dessix_create_block --args '{"patch":{"type":"Action","title":"