Quickstart

Install the mog CLI, authenticate, and install your first skill in under 5 minutes.

Get from zero to your first installed skill in under 5 minutes.

Step 1 — Install the CLI

mog is published to npm. Install it globally:

npm install -g mogmd

Verify the install:

mog --version
# 0.1.0

Step 2 — Authenticate

mog uses a device code flow (RFC 8628) so authentication works in headless environments, CI, and inside agent runners — no browser required on the machine running the CLI.

mog auth

The CLI will print a short code and a URL:

  To authenticate, visit:
    https://mog.md/device

  Enter code: XKCD-7Z4B

  Waiting for approval...

Open mog.md/device in your browser (the CLI will try to open it automatically), sign in with GitHub or Google, and enter the code. The CLI polls automatically and confirms once approved:

  ✓ Authenticated!
  ✓ You are now signed in to mog.md

Your token is stored in:

macOS: ~/Library/Application Support/mog/credentials.json
Linux: ~/.config/mog/credentials.json
Windows: %APPDATA%\mog\credentials.json

Check your auth status any time:

mog auth --status

Step 3 — Search for a skill

mog search "react testing"
 
# 3 results
 
# acme/react-testing-skill@1.2.0  Free
#   skill     cursor, claude-code  by Acme Corp ✓
#   Comprehensive React testing patterns including RTL, Vitest, and MSW
 
# Install with: mog install <vendor>/<package>

Filter your search:

# Only free packages
mog search --free
 
# Only skills compatible with Cursor
mog search --target cursor
 
# Sort by newest
mog search "testing" --sort recent
 
# Get JSON output (for scripting)
mog search "testing" --json

Step 4 — Install a package

Free packages

mog install acme/react-testing-skill

The CLI auto-detects your environment (looks for .cursor/ or .claude/ in the current directory) and installs to the right location:

  Target: cursor
  ✓ Installed acme/react-testing-skill@1.2.0
    → .cursor/skills/react-testing-skill/
    Lockfile updated: mog.lock.json

Paid packages

For paid packages, purchase first then install:

# Buy first
mog buy acme/premium-skill
 
# Then install
mog install acme/premium-skill

Or combine both steps with --auto-buy:

mog install acme/premium-skill --auto-buy

Add --max-price <cents> to set a ceiling. If the package costs more, the purchase is blocked and an approval URL is returned:

mog install acme/expensive-skill --auto-buy --max-price 500

Preflight (dry run)

See exactly what would happen before committing:

mog install acme/react-testing-skill --preflight
 
# Preflight plan:
#   Package:     acme/react-testing-skill@1.2.0
#   Target:      cursor
#   Install to:  /my-project/.cursor/skills/react-testing-skill/
#   SHA-256:     a3f8...
#   Price:       Free

Step 5 — Manage installed packages

List installed

mog ls
 
# 2 installed packages
 
# acme/react-testing-skill@1.2.0  cursor
#   /my-project/.cursor/skills/react-testing-skill/
#   Installed: 1/15/2026

Update

# Check for updates (dry run)
mog update --dry-run
 
# Apply updates (patch and minor only by default)
mog update

Uninstall

mog uninstall acme/react-testing-skill

Next steps

Full CLI reference — all commands, flags, and exit codes
Spend policies — set up safe autonomous purchasing for agents
Package format — publish your own skills
Selling on mog — monetize your work