omm-view — Architecture Viewer

Purpose

Launch the interactive web viewer so the user can explore .omm/ architecture diagrams in their browser.

Prerequisites

Ensure the omm CLI is available:

command -v omm || npm install -g oh-my-mermaid

If the install command fails (permission denied), tell the user: "Please run npm install -g oh-my-mermaid in your terminal, then try again."

Steps

Step 1: Verify .omm/ exists

omm list

If no classes found, tell the user: "No architecture docs found. Run /omm-scan first to generate them." Then stop.

Step 2: Start the viewer

omm view

If the user specified a port:

omm view --port <port>

Step 3: Report

Tell the user the viewer is running and provide the URL (default: http://localhost:3000).

The viewer auto-refreshes when .omm/ files change.

Rules

• Always check for existing classes before starting the viewer
• If no classes exist, suggest /omm-scan instead of starting an empty viewer
• The viewer is read-only — it does not modify .omm/ files