hive-debugger

Analyze multi-level runtime logs to diagnose and fix Hive agent issues.

10.9k|5.7k|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/aden-hive/hive --skill hive-debugger-aden-hive
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hive-debugger
Source: https://github.com/aden-hive/hive/tree/main/.claude/skills/hive-debugger
Command: npx skills add https://github.com/aden-hive/hive --skill hive-debugger-aden-hive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interactive debugging companion that helps developers identify runtime issues in Hive agents. It analyzes runtime logs across L1/L2/L3, categorizes problems, and provides actionable fix recommendations.

Core Features & Use Cases

  • Multilevel analysis: parses and classifies logs at L1/L2/L3 to surface root causes.
  • Guided workflow: supports Stage 1 Setup, Stage 2 Mode Selection, Stage 3 Triage, Stage 4 Diagnosis, Stage 5 Root Cause, Stage 6 Fix Recommendations, and Stage 7 Verification.
  • MCP integration: generates structured queries to inspect logs, sessions, and checkpoints, enabling rapid triage and recovery.
  • Recovery-first: includes templates for fixes and recovery commands to resume or rollback sessions when needed.

Quick Start

Launch the TUI, select your Hive agent, and start a debugging session to begin structured triage.

Frequently Asked Questions about hive-debugger

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

FAQPage Schema
How do I debug runtime issues in Hive agents?

To debug runtime issues in Hive agents, you analyze multi-level runtime logs across L1, L2, and L3. This process categorizes problems and provides actionable fix recommendations through a structured triage workflow.

What is the best way to triage Hive agent failures using runtime logs?

The best way to triage Hive agent failures is by parsing and classifying multi-level runtime logs to surface root causes. This guided workflow takes you through setup, mode selection, diagnosis, and fix recommendations.

Can I resume or rollback Hive agent sessions after a runtime failure?

Yes, you can resume or rollback Hive agent sessions after a runtime failure. The debugging process includes recovery commands and actionable templates to restore normal operations efficiently.

Does the Hive debugger require any prior configuration to start diagnosing agents?

No prior configuration is required to start diagnosing Hive agents. You can launch the debugging interface directly, select your Hive agent, and begin structured triage immediately without making initial changes.

How does MCP integration help with root-cause analysis for Hive agents?

MCP integration helps with root-cause analysis by generating structured queries to inspect runtime logs, sessions, and checkpoints. This enables rapid evidence gathering for accurate triage and recovery.

What stages are involved in structured debugging for Hive runtime errors?

Structured debugging for Hive runtime errors involves seven stages: Setup, Mode Selection, Triage, Diagnosis, Root Cause, Fix Recommendations, and Verification. This workflow ensures comprehensive issue resolution.