Omm Push

1---
2name: omm-push
3description: Push architecture docs to oh-my-mermaid cloud. Handles login, link, and push workflow with error guidance. Use when the user says "omm push", "push to cloud", "deploy architecture", or "share architecture".
4---
5 
6# omm-push — Cloud Push Workflow
7 
8## Purpose
9 
10Automate the full workflow of pushing .omm/ architecture docs to the oh-my-mermaid cloud service.
11 
12## Prerequisites
13 
14Ensure the `omm` CLI is available:
15 
16```bash
17command -v omm || npm install -g oh-my-mermaid
18```
19 
20If the install command fails (permission denied), tell the user:
21"Please run `npm install -g oh-my-mermaid` in your terminal, then try again."
22 
23## Workflow
24 
25### Step 1: Check Login Status
26 
27Run `omm share` via Bash. If it errors with "not logged in":
28- Tell the user: "You need to log in first."
29- Run `omm login` — this opens a browser for GitHub OAuth
30- Wait for the user to complete login
31 
32### Step 2: Check Project Link
33 
34Run `omm share` via Bash. If it errors with "no project slug":
35- Run `omm link` — this sets the cloud project slug from the directory name
36- Confirm: "Linked to {slug}"
37 
38### Step 3: Push
39 
40Run `omm push` via Bash.
41 
42Handle errors:
43- **401 Unauthorized**: "Login expired. Run `omm login` again."
44- **403 Free plan limit**: "Free plan allows 1 project. Upgrade at https://ohmymermaid.com/pricing"
45- **Network error**: "Cannot reach server. Check your connection."
46 
47### Step 4: Report
48 
49On success, output:
50- Number of files uploaded
51- View URL: `https://ohmymermaid.com/p/{slug}`
52- Share URL (if Pro): "Run `omm share` to get the shareable link"
53 
54## Rules
55 
56- Always check login before pushing
57- Always check link before pushing
58- Do NOT skip steps — each depends on the previous
59- If any step fails, stop and report the error with guidance
60