---
name: Omm Push
slug: omm-push
category: Automation
description: "Omm Push pushes architecture docs to oh-my-mermaid cloud, handling login, link, and push workflow with error guidance. Use it when the user says 'omm push', 'push to cloud', 'deploy architecture', or 'share architecture'."
github: "https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push"
language: TypeScript
stars: 2190
forks: 187
install: "npx degit https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push ~/.claude/skills/omm-push"
installs_to: ~/.claude/skills/omm-push
source_path: skills/omm-push/SKILL.md
collection_size: 3
category_size: 1523
collection_url: "https://dirskills.com/collections/oh-my-mermaid/oh-my-mermaid"
added: 2026-08-18T06:58:25.055Z
last_synced: 2026-08-18T06:58:25.055Z
canonical_url: "https://dirskills.com/skills/omm-push"
---

# Omm Push

Omm Push pushes architecture docs to oh-my-mermaid cloud, handling login, link, and push workflow with error guidance. Use it when the user says 'omm push', 'push to cloud', 'deploy architecture', or 'share architecture'.

**Install:**

```bash
npx degit https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-push ~/.claude/skills/omm-push
```

## README

# omm-push — Cloud Push Workflow

## Purpose

Automate the full workflow of pushing .omm/ architecture docs to the oh-my-mermaid cloud service.

## Prerequisites

Ensure the `omm` CLI is available:

```bash
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."

## Workflow

### Step 1: Check Login Status

Run `omm share` via Bash. If it errors with "not logged in":
- Tell the user: "You need to log in first."
- Run `omm login` — this opens a browser for GitHub OAuth
- Wait for the user to complete login

### Step 2: Check Project Link

Run `omm share` via Bash. If it errors with "no project slug":
- Run `omm link` — this sets the cloud project slug from the directory name
- Confirm: "Linked to {slug}"

### Step 3: Push

Run `omm push` via Bash.

Handle errors:
- **401 Unauthorized**: "Login expired. Run `omm login` again."
- **403 Free plan limit**: "Free plan allows 1 project. Upgrade at https://ohmymermaid.com/pricing"
- **Network error**: "Cannot reach server. Check your connection."

### Step 4: Report

On success, output:
- Number of files uploaded
- View URL: `https://ohmymermaid.com/p/{slug}`
- Share URL (if Pro): "Run `omm share` to get the shareable link"

## Rules

- Always check login before pushing
- Always check link before pushing
- Do NOT skip steps — each depends on the previous
- If any step fails, stop and report the error with guidance