Skip to main content
AI/MLLeeJuOh

claw-mo-down

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.

Stars
45
Source
LeeJuOh/claude-code-zero
Updated
2026-05-25
Slug
LeeJuOh--claude-code-zero--claw-mo-down
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/LeeJuOh/claude-code-zero/HEAD/plugins/claw-mo/skills/claw-mo-down/SKILL.md -o .claude/skills/claw-mo-down.md

Drops the SKILL.md into .claude/skills/claw-mo-down.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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.