novauptime

CLI for Nova Uptime — monitor website uptime, SSL certificates, and email health from your terminal.

npm install -g novauptime

Quick Start

# Sign in (no browser required — email OTP)
novauptime auth login

# View all monitored domains
novauptime status

# Add a domain
novauptime domains add https://example.com

# Check email health for any domain
novauptime email-health check example.com

Authentication

Nova Uptime CLI uses email OTP — no browser or password needed.

# Sign in or create an account
novauptime auth login

# Check auth status
novauptime auth status

# Sign out
novauptime auth logout

On first login, an API key is generated automatically and stored locally.

You can also pass an API key directly:

novauptime --api-key YOUR_KEY status

Or set it via environment variable:

export NOVAUPTIME_API_KEY=your_key_here

Commands

Domains

novauptime domains list                  # List all domains
novauptime domains ls --state down       # Filter by state (up/down/degraded)
novauptime domains get <id>              # Get domain details
novauptime domains add https://example.com               # Add domain
novauptime domains add https://example.com --interval 300  # 5-min checks
novauptime domains update <id> --interval 600             # Change to 10-min
novauptime domains delete <id>           # Remove domain
novauptime domains pause <id>            # Pause monitoring
novauptime domains resume <id>           # Resume monitoring
novauptime domains history <id>          # Check history (last 24h)
novauptime domains history <id> --hours 168  # Last 7 days
novauptime domains incidents <id>        # View incidents
novauptime domains email-health <id>     # Run email health check
novauptime domains tag <id> tag1 tag2    # Assign tags

URL Monitoring

novauptime urls list                     # List monitored URLs
novauptime urls ls --state changed       # Filter by state
novauptime urls add https://example.com/pricing           # Add URL
novauptime urls add https://example.com/api --interval 3600  # Hourly checks
novauptime urls update <id> --detect-changes              # Enable change detection
novauptime urls delete <id>              # Remove URL
novauptime urls pause <id>               # Pause monitoring
novauptime urls resume <id>              # Resume monitoring
novauptime urls changes <id>             # View content changes
novauptime urls screenshots <id>         # View screenshot history

Email Health

novauptime email-health check example.com          # Check any domain
novauptime email-health check example.com --fresh  # Skip cache

Checks MX, SPF, DKIM, DMARC records and blacklist status. Returns a score (0-100) and grade (A-F).

Status Overview

novauptime status        # Dashboard summary of all monitors

Tags / Folders

novauptime tags list                        # List all tags
novauptime tags create "Production"         # Create tag
novauptime tags create "Staging" --color "#22c55e"  # With color
novauptime tags update <id> --name "Prod"   # Rename
novauptime tags delete <id>                 # Delete tag

Notifications

novauptime notifications list              # Recent notifications
novauptime notifications list --type status_change  # Filter by type
novauptime notifications unread            # Unread count

Incidents

novauptime incidents                       # List recent incidents
novauptime incidents --limit 20            # More results
novauptime domains incidents <id>          # Incidents for a specific domain

Team

novauptime team list                       # List team members
novauptime team invite [email protected]    # Invite member
novauptime team invite [email protected] --domains id1,id2  # With domain access
novauptime team remove <membershipId>      # Remove member
novauptime team resend <membershipId>      # Resend invite

Webhooks

novauptime webhooks list                   # List webhooks
novauptime webhooks list --domain-id <id>  # For specific domain
novauptime webhooks create --url https://hooks.example.com/uptime --domain-id <id>
novauptime webhooks test <id>              # Test delivery
novauptime webhooks delete <id>            # Remove webhook

Billing

novauptime billing summary                 # Current plan & usage
novauptime billing history                 # Payment history

Account

novauptime account                         # Account details & plan info

Configuration

novauptime config get                      # Show current config
novauptime config set api-url https://api.novauptime.com  # Set API URL
novauptime config set default-output json  # Default to JSON output
novauptime config path                     # Show config file location

Output Formats

# Human-readable (default)
novauptime domains list

# JSON output
novauptime domains list --json

# Or set JSON as default
novauptime config set default-output json

Check Intervals

| Plan | Min Interval | Domains | URLs | |---------|-------------|---------|-------| | Free | 24 hours | 5 | 5 | | Pro | 59 seconds | 100 | 100 | | Agency | 59 seconds | 1,000 | 1,000 |

Requirements

• Node.js 18 or higher
• A Nova Uptime account (free tier available)

Links

• Nova Uptime
• CLI Documentation
• API Documentation
• Email Health Checker (free tool)

License

MIT