How do I install the Pulse skill?

Run npx skillmds@latest add kbarbel640-del/pulse in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pulse safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pulse?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pulse free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

kbarbel640-del (@kbarbel640-del) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pulse by kbarbel640-del — Agent Skill

Name: Pulse
Rating: 4.666666666666667 (3 reviews)
Author: kbarbel640-del

Pulse

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.

kbarbel640-del Updated Sep 8, 2026 1 repo stars

File contents

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

---name: pulsedescription: 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 APICLI tool for interacting with Pulse infrastructure monitoring system.## ConfigurationSet environment variables or pass flags:- `PULSE_URL` - Base URL (default: `https://demo.pulserelay.pro`)- `PULSE_TOKEN` - API token for authentication (pre-configured)## Quick Start```bash# Check system healthpulse health# Get complete infrastructure statepulse state# Get resource summarypulse resources --stats# View specific resourcepulse resource <resource-id># Get metrics for a time rangepulse metrics --range 24h```## Core Operations### System Health```bashpulse health# Returns: status, uptime, timestamp```### Infrastructure State```bashpulse state# Complete state: Nodes, VMs, Containers, Storage, Alerts```### Resources```bashpulse resources # List all resourcespulse resources --stats # Summary counts and healthpulse resource <id> # Single resource details```### Metrics & Charts```bashpulse metrics --range 1h # CPU, Memory, Storage chartspulse metrics --range 24hpulse metrics --range 7d# Available ranges: 5m, 15m, 30m, 1h, 4h, 12h, 24h, 7dpulse storage-stats # Detailed storage usagepulse backups # Unified backup history```### Notifications```bashpulse test-notification # Send test alertpulse notification-health # Check notification system```### Updates```bashpulse updates check # Check for Pulse updatespulse updates status # Current update statuspulse updates apply # Apply available updates```## Advanced Features### Agent Management```bashpulse agents list # List all agentspulse agent <id> config # Get agent configurationpulse agent <id> unlink # Unlink agent from node```### Security```bashpulse tokens list # List API tokenspulse token create --name "automation" --scopes "monitoring:read"pulse token revoke <id> # Revoke token```### AI Features (Pro)```bashpulse ai status # AI patrol statuspulse ai findings # Current AI findingspulse ai run # Trigger AI patrol run```## Environment SetupCreate a helper script at `~/.local/bin/pulse`:```bash#!/bin/bash# Pulse CLI wrapperPULSE_URL="${PULSE_URL:-https://demo.pulserelay.pro}"PULSE_TOKEN="${PULSE_TOKEN:-a4b819a65b8d41318d167356dbf5be2c70b0bbf7d5fd4687bbf325a6a61819e0}"endpoint="$1"shiftcurl -s -H "X-API-Token: $PULSE_TOKEN" \ "${PULSE_URL}/api/${endpoint}" "$@" | jq```Make it executable:```bashchmod +x ~/.local/bin/pulse```## Common Patterns### Get RAM usage for a host```bashpulse state | jq '.hosts[] | {name: .displayName, memory}'```### List all containers with high CPU```bashpulse state | jq '.containers[] | select(.cpu > 80)'```### Get alerts```bashpulse state | jq '.alerts'```### Export metrics to JSON```bashpulse metrics --range 24h > metrics-$(date +%Y%m%d).json```## Authentication Methods### API Token (Recommended)```bashcurl -H "X-API-Token: your-token" http://pulse:7655/api/health```### Bearer Token```bashcurl -H "Authorization: Bearer your-token" http://pulse:7655/api/health```### Session CookieUsed by web UI automatically.## Reference Files- **[API.md](references/API.md)** - Complete API endpoint reference- **[examples.sh](scripts/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`

Frequently asked questions