Overview
hive.terminal-tools-troubleshooting is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. Its author describes it as: “Read when a terminal-tools call returned something surprising — empty stdout despite no error, exit_code is null, output_handle came back expired, "too many jobs" / "session busy" / "too many PTYs", warning was set un…”. The project has 11k stars on GitHub and is available under the Apache-2.0 license. Add it to your setup with `git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-troubleshooting`.
What hive.terminal-tools-troubleshooting does
Recipes for surprising results. Match the symptom to the section.
What’s inside
The SKILL.md for hive.terminal-tools-troubleshooting is organised into these sections:
- Empty stdout despite the command "should have" produced output
- exitcode: null
- outputhandle returned expired: true
- "too many jobs" / JobLimitExceeded
- "session busy"
- "PTY cap reached"
- warning is set, the command worked
- semanticstatus: "ok" but exitcode: 1
- semanticstatus: "error" but exitcode: 0
- truncatedbytesdropped > 0 in terminaljoblogs
- terminalptyopen succeeds but the first run times out
- shell="/bin/zsh" returned an error
Installation
Add hive.terminal-tools-troubleshooting to your agent with:
git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-troubleshootingReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
Neither the skill nor its repository names a specific agent. It uses the SKILL.md format, which several agents can load — check the repository for any agent-specific requirements.
License
hive.terminal-tools-troubleshooting is published under the Apache-2.0 license.
Strengths
- Clear Apache-2.0 license — safe to read and adapt within its terms
- Ships in aden-hive/hive, an established project with 10,923 GitHub stars
- Actively maintained — repository updated in the last 90 days
Author
Topics
Frequently asked questions
- What does hive.terminal-tools-troubleshooting do?
- Read when a terminal-tools call returned something surprising — empty stdout despite no error, exit_code is null, output_handle came back expired, "too many jobs" / "session busy" / "too many PTYs", warning was set unexpectedly, semantic_status disagrees with exit_code. Diagnostic recipes only — load on demand. Don't preload; the foundational skill covers the happy path.
- How do I install hive.terminal-tools-troubleshooting?
- Run git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-troubleshooting in your agent, then reload your skills. Review the source at https://github.com/aden-hive/hive before installing.
- Is hive.terminal-tools-troubleshooting free to use?
- Yes. hive.terminal-tools-troubleshooting is free and open source under the Apache-2.0 license, so you can read, run, and adapt it within that license's terms.
- Where does hive.terminal-tools-troubleshooting come from?
- hive.terminal-tools-troubleshooting ships inside aden-hive/hive, a repository that contains 25 catalogued skills in total. The repository's 10,923 GitHub stars apply to that whole collection, not to this skill on its own.