antongulin/mole-skills/mole-status

Mole Status Skill

Author: Anton Gulin · Tool: opencode-skill-creator · GitHub: @antongulin · Registry: skills.sh

Use this skill when you need to help a user check macOS system health using Mole's status command.

Overview

mo status launches a live system health dashboard (built with Bubble Tea) that shows real-time system metrics in an interactive TUI.

Command Reference

Basic Usage

mo status          # Launch live system health dashboard
mo status --help   # Show help

Flags

The status command has no other flags — it's designed as a live monitoring tool.

What It Shows

The status dashboard displays these real-time metrics:

• Memory usage — RAM used vs total (GB)
• Disk usage — Disk used vs total (GB)
• Disk usage percentage — Percentage of disk space used
• Uptime — System uptime in days
• Additional system info — macOS version, architecture, kernel, SIP status, free disk space (shown by mo --version and mo help)

Workflow Patterns

Pattern 1: Quick Health Check

mo status

Opens the TUI dashboard. The user can inspect metrics and press q to quit.

Pattern 2: Free Disk Space Quick Check

Before cleanup operations, check free space:

mo status

Or use:

mo --version

Which shows a concise system summary including free space.

Pattern 3: System Information

For a non-interactive system summary:

mo --version

Outputs:

• Mole version
• macOS version
• Architecture
• Kernel
• SIP status
• Disk free space
• Install method (Homebrew/Manual)
• Shell
• Channel (stable/nightly)

Metrics Interpretation

• Memory (RAM): Higher used GB may indicate memory pressure. If > 80% of total, suggest closing unused apps.
• Disk: If > 85% used, suggest mo clean --dry-run to preview cleanup potential.
• Uptime: Long uptime (> 30 days) may benefit from a restart to clear temporary system caches.
• SIP (System Integrity Protection): Disabled SIP can indicate deeper system access but reduces security.

Safety Guidance

• The status command is read-only — it never modifies system files
• All metrics are collected from standard macOS tools (sysctl, df, sw_vers, uname, csrutil)
• No sudo required for any status information

Related Commands

• mo clean — Free up disk space after checking status
• mo optimize — Refresh caches and services
• mo analyze — Deep-dive into disk usage
• mo --version — System info and free space in non-interactive mode

Examples

Common workflows combining status with other commands:

# 1. Check current disk usage
mo status
 
# 2. Preview what can be cleaned
mo clean --dry-run
 
# 3. Actually clean
mo clean
 
# 4. Verify freed space
mo status