메뉴
Node.js CLI for interacting with the AO Task Monitor API - get system health, alerts, logs, and task metrics for AO processes
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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
| 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