| name | self-observe |
| description | Observe OpenPPX Node health with usage, automation status, audit facts, logs, and quick diagnostics. |
Self Observe Skill
Use this skill when the user asks for agent self-inspection, runtime health checks, or diagnostics such as token cost, error logs, and service status.
What To Check
- Token usage:
ppx operations usage --json
ppx operations usage --provider google --limit 50 --json
ppx operations usage --provider openai --limit 50 --json
- Runtime status:
ppx operations status --json
ppx operations health --json
ppx operations heartbeat status --json
ppx operations cron list --json
- Error logs (read-only):
tail -n 200 ~/.openppx/logs/node.err.log
rg -n "ERROR|Error|Traceback|Exception|failed|timeout" ~/.openppx/logs/node.err.log ~/.openppx/logs/node.out.log
- SQLite quick verification (if
sqlite3 exists):
sqlite3 ~/.openppx/database/token_usage.db "SELECT provider, COUNT(*) AS requests, SUM(total_tokens) AS total_tokens FROM llm_token_usage_events GROUP BY provider ORDER BY total_tokens DESC;"
sqlite3 ~/.openppx/database/token_usage.db "SELECT response_at, provider, model, request_tokens, response_tokens, total_tokens FROM llm_token_usage_events ORDER BY response_at_ms DESC LIMIT 20;"
Fast Path
Generate one consolidated report:
bash openppx/skills/self-observe/scripts/self_status_report.sh
Output Format
When reporting to user, include:
- Runtime Summary: Node/heartbeat/cron health highlights.
- Token Summary: total requests/tokens and provider split.
- Recent Errors: latest error signatures with file and timestamp.
- Risks: what might break soon (missing usage data, repeated failures, disconnected provider).
- Next Actions: concrete commands to validate/fix.
Guardrails
- Keep checks read-only by default.
- Do not delete or truncate logs unless the user explicitly asks.
- If status/log files are missing, report "not found" explicitly instead of guessing.
- Prefer structured output (
--json) first, then summarize in natural language.
