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.