---

name: pulse description: Query and control Pulse monitoring system via REST API. Use for checking infrastructure health, resource status (nodes/VMs/containers/storage), metrics, alerts, and system management. Supports authentication via API token or session. Use when user asks about Pulse status, infrastructure monitoring, or needs to interact with the Pulse dashboard programmatically.

Pulse Monitoring API

CLI tool for interacting with Pulse infrastructure monitoring system.

Configuration

Set environment variables or pass flags:

• PULSE_URL - Base URL (default: https://demo.pulserelay.pro)
• PULSE_TOKEN - API token for authentication (pre-configured)

Quick Start

# Check system health
pulse health

# Get complete infrastructure state
pulse state

# Get resource summary
pulse resources --stats

# View specific resource
pulse resource <resource-id>

# Get metrics for a time range
pulse metrics --range 24h

Core Operations

System Health

pulse health
# Returns: status, uptime, timestamp

Infrastructure State

pulse state
# Complete state: Nodes, VMs, Containers, Storage, Alerts

Resources

pulse resources              # List all resources
pulse resources --stats      # Summary counts and health
pulse resource <id>          # Single resource details

Metrics & Charts

pulse metrics --range 1h     # CPU, Memory, Storage charts
pulse metrics --range 24h
pulse metrics --range 7d

# Available ranges: 5m, 15m, 30m, 1h, 4h, 12h, 24h, 7d

pulse storage-stats          # Detailed storage usage
pulse backups                # Unified backup history

Notifications

pulse test-notification      # Send test alert
pulse notification-health    # Check notification system

Updates

pulse updates check          # Check for Pulse updates
pulse updates status         # Current update status
pulse updates apply          # Apply available updates

Advanced Features

Agent Management

pulse agents list            # List all agents
pulse agent <id> config      # Get agent configuration
pulse agent <id> unlink      # Unlink agent from node

Security

pulse tokens list            # List API tokens
pulse token create --name "automation" --scopes "monitoring:read"
pulse token revoke <id>      # Revoke token

AI Features (Pro)

pulse ai status              # AI patrol status
pulse ai findings            # Current AI findings
pulse ai run                 # Trigger AI patrol run

Environment Setup

Create a helper script at ~/.local/bin/pulse:

#!/bin/bash
# Pulse CLI wrapper
PULSE_URL="${PULSE_URL:-https://demo.pulserelay.pro}"
PULSE_TOKEN="${PULSE_TOKEN:-a4b819a65b8d41318d167356dbf5be2c70b0bbf7d5fd4687bbf325a6a61819e0}"

endpoint="$1"
shift

curl -s -H "X-API-Token: $PULSE_TOKEN" \
     "${PULSE_URL}/api/${endpoint}" "$@" | jq

Make it executable:

chmod +x ~/.local/bin/pulse

Common Patterns

Get RAM usage for a host

pulse state | jq '.hosts[] | {name: .displayName, memory}'

List all containers with high CPU

pulse state | jq '.containers[] | select(.cpu > 80)'

Get alerts

pulse state | jq '.alerts'

Export metrics to JSON

pulse metrics --range 24h > metrics-$(date +%Y%m%d).json

Authentication Methods

API Token (Recommended)

curl -H "X-API-Token: your-token" http://pulse:7655/api/health

Bearer Token

curl -H "Authorization: Bearer your-token" http://pulse:7655/api/health

Session Cookie

Used by web UI automatically.

Reference Files

• API.md - Complete API endpoint reference
• examples.sh - Common API usage examples

Notes

• Most endpoints require authentication (except /health, /version)
• Some endpoints require admin privileges or specific scopes
• Pro features require a Pulse Pro license
• Default base URL: https://demo.pulserelay.pro/api