ha-logs

Query local SQLite databases to diagnose Hope Agent failures.

1.4k|129|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/shiwenwen/hope-agent --skill ha-logs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ha-logs
Source: https://github.com/shiwenwen/hope-agent/tree/main/skills/ha-logs
Command: npx skills add https://github.com/shiwenwen/hope-agent --skill ha-logs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When Hope Agent is failing, slowing down, stuck, or behaving unexpectedly, this Skill lets you investigate the real cause using the agent’s persisted local SQLite logs instead of guessing or asking the user to paste snippets.

Core Features & Use Cases

  • Self-service diagnostics from local evidence: Queries the agent’s on-disk databases to pull the exact error messages, tool failures, session context, and async job status for the relevant time window.
  • Fast drill-down and root-cause discipline: Starts broad (recent ERROR/WARN) and narrows by category, session_id, tool_name, or message content, linking failures to tool payloads where available.
  • Fix verification: Re-runs the same targeted queries after a configuration or code change to confirm the error trend stops.

Quick Start

Ask the agent: Looking at the last 30 minutes, what errors or warnings caused the issue and which tool calls or async jobs failed for the affected session?

Frequently Asked Questions about ha-logs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I investigate Hope Agent failures using local SQLite logs?

You can diagnose Hope Agent failures by querying local SQLite databases containing logs, sessions, messages, and async jobs directly for evidence. This approach pulls exact error messages and tool failures for the relevant time window.

What is the best way to analyze tool error rates and stuck behavior in Hope Agent?

The best way to analyze tool error rates and stuck behavior is a fast drill-down method: start broad with recent ERROR and WARN entries, then narrow results by category, session_id, tool_name, or message content to link failures to specific tool payloads.

Can I verify a Hope Agent fix by re-running targeted SQLite log queries?

Yes, you can perform post-fix verification by re-running the same targeted SQLite log queries after applying a configuration or code change to confirm that the error trend stops within the affected time window.

Does diagnosing Hope Agent async jobs require write access to the database?

No, diagnosing Hope Agent async jobs requires a read-only SELECT-only workflow using the exec tool with sqlite3 or a python3 read-only SQLite connection. This ensures safe session forensics and error investigation without modifying the underlying data.

What limitations exist when querying local SQLite logs for session forensics?

A limitation is that session forensics and error investigation depend entirely on the availability of local on-disk SQLite databases. You must apply time-bounded filters and SELECT-only queries, as direct database modifications are not supported.