claw-mo-up

claw-mo-up

Start the mo markdown viewer server for the current project and open it in the browser.

For config schema, port logic, groups, and browser opening: read ${PLUGIN_DIR}/references/shared.md

Steps

1. Check prerequisites: command -v mo >/dev/null 2>&1
2. Get project key: git rev-parse --show-toplevel (fallback: $PWD)
3. Read config from ${PLUGIN_DATA_DIR}/config.json for this project key
4. No config found → tell user to run /claw-mo-setup, stop
5. If config has patterns (v1), migrate to groups format and save back
6. mo --status --json → check if server already running on this port
7. Not running → start mo for each group:

   # First group starts the server
   mo --no-open -w 'pattern1' -w 'pattern2' --target groupName -p PORT
   # Subsequent groups add to the running server
   mo --no-open -w 'pattern3' --target anotherGroup -p PORT
   

8. Open browser:
   • cmux ($CMUX_SURFACE_ID set): check if a mo browser surface already exists from a previous run. If yes, cmux browser "$SURFACE_ID" navigate "http://localhost:$PORT" to reuse it. If no, cmux browser open "http://localhost:$PORT".
   • Non-cmux: open "http://localhost:$PORT"
9. Report: which groups started, how many patterns, the URL

Gotchas

• Always --no-open when starting mo — the skill controls browser opening separately
• mo survives shell exit and uses single-instance detection — multiple starts are safe
• Start groups sequentially, not in parallel — the first invocation must start the server before others can add to it
• In cmux, cmux browser open creates a new browser surface each time. If the user already has mo open in a browser surface, prefer cmux browser navigate to reuse it instead of creating a duplicate tab. See shared.md for details.