---
name: claw-mo-down
disable-model-invocation: true
description: "Stop the mo markdown viewer server for the current project. Use when the user says claw-mo-down, wants to stop mo, shut down doc viewer, or kill mo server."
allowed-tools: Bash, Read
---

# claw-mo-down

Stop the mo markdown viewer server for the current project, with accurate reporting of whether it was actually running.

For config schema and `--shutdown` semantics: read `${CLAUDE_PLUGIN_ROOT}/references/shared.md`

## Steps

1. **Prerequisites**: `command -v mo >/dev/null 2>&1`. If missing, tell the user `brew install k1LoW/tap/mo` and stop.

2. **Project key**: `git rev-parse --show-toplevel` (fallback: `$PWD`).

3. **Read config** from `${CLAUDE_PLUGIN_DATA}/config.json`. If no entry for this project, tell the user no mo server is configured for this project and stop.

4. **Check actual running state**: `mo --status --json 2>/dev/null`. Look for a server whose port matches `$PORT`.
   - **Not running**: tell the user "mo is not running on :$PORT (nothing to stop). Config preserved." and stop.
   - **Running**: continue to step 5.

5. **Shutdown**: `mo --shutdown -p $PORT`

6. **Verify**: re-run `mo --status --json 2>/dev/null` and confirm the port is gone. Report the result:
   - Success → "Stopped mo on :$PORT. Config preserved — run `/claw-mo-up` to restart."
   - Still present → warn the user (rare; orphaned process) and suggest `kill <pid>` using the PID from status.

## Gotchas

- **Config is preserved** — shutdown only stops the server, it doesn't delete the project config. `/claw-mo-up` will restart with the same groups.
- **Backup file is preserved** too — next start auto-restores the session. Use `/claw-mo-manage` → Reset session (which runs `--clear`) if you want a clean slate.
- **If no server is running on that port, `mo --shutdown` exits silently** — that's why this skill checks `--status --json` first and reports accurately instead of always saying "shut down".
- **Don't shut down a server belonging to another project** — the config key is project-scoped, so this skill only touches the port registered for the current project key.