Menu
Node.js CLI for interacting with the AO Task Monitor API - get system health, alerts, logs, and task metrics for AO processes
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Upload files and websites to permanent storage on Arweave (permaweb), and manage ArNS domain records. Use when the user wants to publish content to Arweave, deploy a static site to the permaweb, or attach a transaction to an ArNS name (ar.io).
Build Single Page Applications using Scout Atoms + json-render + onhyper deployment stack. Creates Vite-based React apps with SSE streaming, component catalogs, and one-command deployment to onhyper.io. Triggers: (1) Creating new SPAs with AI-powered content generation, (2) Building component catalogs with atom schemas, (3) Deploying single-file HTML apps to onhyper.io, (4) Setting up Scout API integration with proxy layer, (5) Working with SSE streaming patterns.
CLI for interacting with AO processes using @permaweb/aoconnect - spawn processes, send messages, read results, monitor messages, and dry run
Based on SOC occupation classification
| name | monitor |
| description | Node.js CLI for interacting with the AO Task Monitor API - get system health, alerts, logs, and task metrics for AO processes |
| license | MIT |
| compatibility | node |
| metadata | {"audience":"developers","workflow":"monitoring","runtime":"Node.js 18+"} |
A Node.js command-line interface for the AO Task Monitor service. Query system health, view alerts, analyze logs, and monitor AO process performance.
skills/monitor/index.mjshttps://ao-task-monitor.onrender.comUse this CLI when you need to:
The CLI requires an API key set via environment variable.
Contact the AO Task Monitor service administrator to obtain your API key.
For zsh (~/.zshrc):
# Add to ~/.zshrc
export AO_MONITOR_KEY="YOUR_KEY_HERE"
# Reload
source ~/.zshrc
For bash (~/.bashrc):
# Add to ~/.bashrc
export AO_MONITOR_KEY="YOUR_KEY_HERE"
# Reload
source ~/.bashrc
Temporary (current session only):
export AO_MONITOR_KEY="YOUR_KEY_HERE"
Per-command override:
node skills/monitor/index.mjs summary --token "YOUR_KEY_HERE"
Get a system-wide overview of all monitored tasks.
node skills/monitor/index.mjs summary
Options:
--period <1h|4h|8h|24h|48h> - Time window for metrics--include <csv> - Fields to include (e.g., counts,kpis,latency)--format <json|text> - Response format (default: json)Examples:
# Default summary
node skills/monitor/index.mjs summary
# Last 24 hours, text format
node skills/monitor/index.mjs summary --period 24h --format text
# Only counts and KPIs
node skills/monitor/index.mjs summary --include counts,kpis
Get detailed metrics for a specific task.
node skills/monitor/index.mjs task <taskId>
Options:
--period <1h|4h|8h|24h|48h> - Time window for metrics--include <csv> - Fields to include--format <json|text> - Response formatExamples:
# Get ao-token-info task details
node skills/monitor/index.mjs task ao-token-info
# With 48-hour window and text output
node skills/monitor/index.mjs task ao-token-info --period 48h --format text
View current system alerts and issues.
node skills/monitor/index.mjs alerts
Options:
--period <1h|4h|8h|24h|48h> - Time window for alerts--format <json|text> - Response formatExamples:
# Current alerts
node skills/monitor/index.mjs alerts
# Last 4 hours, text format
node skills/monitor/index.mjs alerts --period 4h --format text
View execution logs, optionally filtered by task.
# All logs
node skills/monitor/index.mjs logs
# Task-specific logs
node skills/monitor/index.mjs logs <taskId>
Options:
--limit <n> - Maximum results (default: 100, max: 1000)--offset <n> - Pagination offset--status <success|failure|timeout> - Filter by execution status--error-type <string> - Filter by error message substring--since <isoTimestamp> - Logs after this time--until <isoTimestamp> - Logs before this time--task-id <taskId> - Filter by task ID (alternative to positional arg)Examples:
# Recent logs
node skills/monitor/index.mjs logs
# Task-specific logs
node skills/monitor/index.mjs logs ao-token-info
# Failed executions only
node skills/monitor/index.mjs logs --status failure
# Logs with 503 errors
node skills/monitor/index.mjs logs --error-type 503
# Last 50 logs since yesterday
node skills/monitor/index.mjs logs --limit 50 --since 2024-01-01T00:00:00Z
# Paginated results
node skills/monitor/index.mjs logs --limit 100 --offset 100
Retrieve API documentation from the server.
node skills/monitor/index.mjs docs
Make a generic API request for endpoints not covered by other commands.
node skills/monitor/index.mjs request <endpoint> <method> [body]
Arguments:
endpoint - API path (e.g., /v1/summary)method - HTTP method (GET, POST, PUT, DELETE)body - JSON body for POST/PUT requests (optional)Examples:
# GET request
node skills/monitor/index.mjs request /v1/summary GET
# GET with query params
node skills/monitor/index.mjs request "/v1/summary?format=text" GET
# POST with JSON body
node skills/monitor/index.mjs request /v1/api/agent POST '{"task_id":"123","status":"running"}'
# PUT request
node skills/monitor/index.mjs request /v1/api/agent/456 PUT '{"name":"Updated Agent"}'
These options work with all commands:
| Option | Description |
|---|---|
--base-url <url> | Override API base URL |
--token <token> | Override auth token (instead of AO_MONITOR_KEY) |
--timeout-ms <ms> | Request timeout in milliseconds (default: 30000) |
--help, -h | Show help message |
Examples:
# Use different API server
node skills/monitor/index.mjs summary --base-url https://my-monitor.example.com
# Override token for single request
node skills/monitor/index.mjs alerts --token "different_key"
# Longer timeout for slow connections
node skills/monitor/index.mjs logs --timeout-ms 60000
| Parameter | Values | Description |
|---|---|---|
--period | 1h, 4h, 8h, 24h, 48h | Time window for metrics |
--include | CSV of fields | Fields to include in response |
--format | json, text | Response format |
Include field options:
counts - Execution countskpis - Key performance indicatorslatency - Response time metrics| Parameter | Type | Description |
|---|---|---|
--limit | integer | Max results (1-1000, default: 100) |
--offset | integer | Pagination offset |
--status | string | success, failure, or timeout |
--error-type | string | Filter by error substring |
--since | ISO timestamp | Logs after this time |
--until | ISO timestamp | Logs before this time |
--task-id | string | Filter by task ID |
# Quick overview
node skills/monitor/index.mjs summary --format text
# Check for any alerts
node skills/monitor/index.mjs alerts
# See if task has issues
node skills/monitor/index.mjs task ao-token-info --period 24h
# Get recent failures
node skills/monitor/index.mjs logs ao-token-info --status failure --limit 20
# Search for specific error
node skills/monitor/index.mjs logs --error-type "503" --limit 50
# Last 100 logs
node skills/monitor/index.mjs logs
# Last hour of logs
node skills/monitor/index.mjs logs --since "$(date -u -v-1H +%Y-%m-%dT%H:%M:%SZ)"
# Successful runs only
node skills/monitor/index.mjs logs --status success --limit 50
# Task metrics
node skills/monitor/index.mjs task ao-token-info --include counts,kpis,latency
# Task logs
node skills/monitor/index.mjs logs ao-token-info --limit 50
# Find timeout issues
node skills/monitor/index.mjs logs --status timeout
# Check latency metrics
node skills/monitor/index.mjs summary --include latency
If AO_MONITOR_KEY is not set and no --token provided:
Error: No authentication token provided.
Set the AO_MONITOR_KEY environment variable:
export AO_MONITOR_KEY="your_key_here"
Or use the --token flag:
node skills/monitor/index.mjs summary --token "your_key_here"
401 Unauthorized or 403 Forbidden:
AO_MONITOR_KEY is correctNon-2xx responses display:
Error: Request failed with status 404
Not Found: Task 'invalid-task' does not exist
--timeout-ms for slow connections# System overview
node skills/monitor/index.mjs summary
# Text format summary
node skills/monitor/index.mjs summary --format text
# Last 24h summary
node skills/monitor/index.mjs summary --period 24h
# Check alerts
node skills/monitor/index.mjs alerts
# Task details
node skills/monitor/index.mjs task ao-token-info
# Recent logs
node skills/monitor/index.mjs logs
# Task logs
node skills/monitor/index.mjs logs ao-token-info
# Failed runs
node skills/monitor/index.mjs logs --status failure
# Search errors
node skills/monitor/index.mjs logs --error-type "503"
# API docs
node skills/monitor/index.mjs docs
# Custom request
node skills/monitor/index.mjs request /v1/summary GET