hive-debugger

Diagnose and fix runtime issues in Hive agents from logs and configurations.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/nk10nikhil/hive-spm-clone --skill hive-debugger-nk10nikhil
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hive-debugger
Source: https://github.com/nk10nikhil/hive-spm-clone/tree/main/.claude/skills/hive-debugger
Command: npx skills add https://github.com/nk10nikhil/hive-spm-clone --skill hive-debugger-nk10nikhil

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interactive debugging companion that helps developers identify and fix runtime issues in Hive agents. The debugger analyzes runtime logs at three levels (L1/L2/L3), categorizes issues, and provides actionable fix recommendations.

Core Features & Use Cases

  • Monitors runtime logs across L1/L2/L3 to surface root causes.
  • Produces actionable fix recommendations and guidance for node failures, retries, and timeouts.
  • Works alongside agents in TUI mode and supports supervisor insights and recovery workflows.
  • Forever-alive agent awareness: sessions with terminal_nodes=[] are normal; focus on node-level progress and memory management.

Quick Start

Launch the TUI dashboard, select your agent, and begin debugging with real-time runtime insights.

Frequently Asked Questions about hive-debugger

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

FAQPage Schema
How do I debug a Hive agent that is stalling or looping during runtime?▼

To debug a stalling or looping Hive agent, you need to analyze runtime logs and agent configurations. This debugger processes exported logs at three layers (L1-L3) to surface the root cause and provide actionable fix recommendations.

What is the best way to troubleshoot node failures and timeouts in Hive agents?▼

Troubleshooting node failures and timeouts requires layered runtime log analysis. The debugger monitors L1/L2/L3 logs alongside graph structures to categorize issues and generate actionable remediation templates for recovery.

How does root-cause analysis work for agent development when terminal_nodes are empty?▼

Root-cause analysis for empty terminal_nodes treats this as a normal forever-alive agent state. The debugger shifts focus to node-level progress and memory management rather than treating empty terminals as failures.

Can I use TUI mode to monitor real-time runtime logs for agent troubleshooting?▼

Yes, you can launch the TUI dashboard to monitor real-time runtime logs. It works alongside your active agents to provide supervisor insights, track node-level progress, and guide recovery workflows during testing.

What should I do when my Hive agent fails and I need actionable remediation guidance?▼

When your agent fails, you should process the exported runtime logs and graph structures. The debugger analyzes these inputs to categorize the failure across L1-L3 layers and outputs recommended remediation templates.

Why does my Hive agent session have empty terminal_nodes and is it a runtime error?▼

Empty terminal_nodes in a runtime session is not an error. It indicates a normal forever-alive agent state, meaning debugging efforts should focus on tracking node-level progress and memory management instead.