omm-view

name	omm-view
description	Start the omm web viewer to explore architecture diagrams in the browser. Use when the user says "omm view", "open viewer", "show diagrams", "view architecture", or "open architecture".
argument-hint	[--port <port>]

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