Quepasa

A simple, powerful CLI tool for monitoring health check endpoints.

Get Started Quick Start

What is Quepasa?

Quepasa (Spanish for "What's up?") is a health check monitoring tool that helps you keep tabs on your APIs, microservices, and web applications. It automatically discovers health endpoints, performs checks, and provides a beautiful real-time dashboard.

Features

✅

Automatic endpoint discovery

Just provide a domain, Quepasa finds the health endpoint

📊

Live dashboard

Real-time monitoring with status updates

🔄

Continuous watching

Monitor endpoints at regular intervals

💾

SQLite storage

Track endpoints and check history locally

⚡

Parallel checking

Fast checks for multiple endpoints

🎨

Beautiful output

Clean, colorful terminal UI

Installation

Install as .NET Global Tool

dotnet tool install --global Quepasa.Cli

Update

dotnet tool update --global Quepasa.Cli

Quick Start

Check Any Endpoint

No setup required - just check any health endpoint:

# Check any URL
quepasa check tilecraft.dev

# Auto-discovers common health endpoints
quepasa check github.com

# Custom timeout and retries
quepasa check example.com --timeout 60 --retries 5

Discover Health Endpoints

Find out what health endpoints a service exposes:

quepasa discover api.stripe.com

Output:

✓ Health check endpoint found!

URL: https://api.stripe.com/healthz
Path: /healthz
Status Code: 200
Response Time: 142ms

That's it! No initialization, no database, no setup. Just check and go.

Persistent Monitoring

Want to track a set of endpoints over time? Quepasa can store and continuously monitor your services.

Setup

Initialize the database (one-time):

quepasa init

Add endpoints to track:

# Auto-discovers health endpoints
quepasa add tilecraft.dev --name "Tilecraft"
quepasa add api.example.com --name "My API" --tags production
quepasa add db.example.com --name "Database" --tags production

Run All Checks

Check all your tracked endpoints at once:

quepasa run

Output:

╭─ Health Check Results (3 endpoints) ─────────╮
│ # │ Status      │ Name       │ URL           │
├───┼─────────────┼────────────┼───────────────┤
│ 1 │ ✓ Healthy   │ Tilecraft  │ tilecraft...  │
│ 2 │ ✓ Healthy   │ My API     │ api.exampl... │
│ 3 │ ⚠ Degraded  │ Database   │ db.example... │
╰───┴─────────────┴────────────┴───────────────╯

Watch with Live Dashboard

Monitor your services continuously with real-time updates:

# Check every 5 minutes (default)
quepasa watch

# Check every minute
quepasa watch --interval 1

# Watch only production endpoints
quepasa watch --tag production --parallel

Live Dashboard:

╔══════════════════════════════════════════════════════════╗
║ Watch Dashboard - Check #12                             ║
║ Status: ✓ Idle  |  Endpoints: 3  |  Interval: 5m       ║
║ Last: 15:30:45  |  Next: 15:35:45 (287s)               ║
╚══════════════════════════════════════════════════════════╝

╭─────────────┬────────────┬─────────────┬──────────╮
│ Status      │ Name       │ URL         │ Response │
├─────────────┼────────────┼─────────────┼──────────┤
│ ✓ Healthy   │ Tilecraft  │ tilecraft.. │  142ms   │
│ ✓ Healthy   │ My API     │ api.examp.. │   89ms   │
│ ✗ Unhealthy │ Database   │ db.exampl.. │  534ms   │
╰─────────────┴────────────┴─────────────┴──────────╯

╭────────────────────────────────────────────────────╮
│ Summary: 2 ✓  0  1 ✗  |  Success Rate: 66.7%      │
╰────────────────────────────────────────────────────╯

The dashboard updates in real-time and shows a countdown to the next check. Press Ctrl+C to stop.

All Commands

Basic Commands

# Check any endpoint
quepasa check <url>

# Discover health endpoints
quepasa discover <domain>

Persistent Monitoring Commands

# Initialize database
quepasa init

# Add endpoints
quepasa add <url> --name "Service Name"

# List all tracked endpoints
quepasa list

# List by tag
quepasa list --tag production

# Run all checks once
quepasa run

# Watch continuously
quepasa watch

# Update an endpoint
quepasa update <id> --name "New Name"

# Remove an endpoint
quepasa remove <id>

# View check history
quepasa history
quepasa history --since 24h

Advanced Options

# Parallel checking (faster)
quepasa run --parallel
quepasa watch --parallel --interval 2

# Save history
quepasa run --save-history

# Custom timeout and retries
quepasa check example.com --timeout 60 --retries 5

# JSON output (for scripting)
quepasa run --format json

Automatic Endpoint Discovery

Quepasa automatically tests common health check paths:

/health
/healthz
/health/live
/health/ready
/api/health
/ping
/status
And more...

Just provide the domain and Quepasa does the rest!

Use Cases

Quick Health Checks

Perfect for one-off checks, CI/CD, debugging:

# Is my service up?
quepasa check api.example.com

# Check after deployment
quepasa check $DEPLOYMENT_URL \
  --timeout 30 --retries 3

# Debug local service
quepasa check localhost:3000

CI/CD Pipelines

No setup required - just check and use exit codes:

#!/bin/bash
quepasa check $DEPLOYMENT_URL \
  --timeout 30 --retries 3
exit $?

Development Monitoring

Track multiple local services:

quepasa init
quepasa add localhost:3000 \
  --name "Frontend" --tags local
quepasa add localhost:8080 \
  --name "Backend" --tags local
quepasa watch --tag local \
  --interval 0.5

Production Monitoring

Continuously monitor production services:

quepasa init
quepasa add api.prod.com \
  --name "API" --tags production
quepasa add db.prod.com \
  --name "Database" --tags production
quepasa watch --tag production \
  --parallel

Kubernetes

Monitor Kubernetes services:

quepasa init
quepasa add my-service.default.svc.cluster.local \
  --name "K8s Service"
quepasa watch --interval 2

Database Location

  • Linux/macOS: ~/.local/share/Quepasa/quepasa.db
  • Windows: %APPDATA%\Quepasa\quepasa.db
  • Custom: Set QUEPASA_DB_PATH environment variable

Exit Codes

  • 0 - All checks passed (all healthy)
  • 1 - Some checks failed or degraded
  • 99 - Error running command

Perfect for scripting and automation!

Requirements

.NET 9.0 or later