SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
hive.terminal-tools-troubleshooting
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.
Installation
Add hive.terminal-tools-troubleshooting to your agent with:
git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-troubleshootingAlways review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.
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
When to use it
Reach for hive.terminal-tools-troubleshooting when you want workflow help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.
Strengths
- Clear Apache-2.0 license — safe to read and adapt
- Ships in aden-hive/hive, an established project with 10,923 GitHub stars
- Actively maintained (recent commits)
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.
Related skills
More Workflow →queen-colony-debug is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. It packages reusable instructions an agent loads on demand to help with workflow tasks. 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/queen-colony-debug`.
test-reporting is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. It packages reusable instructions an agent loads on demand to help with workflow tasks. 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/test-reporting`.
triage-issue is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. It packages reusable instructions an agent loads on demand to help with workflow tasks. 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/triage-issue`.
Required before any hive-browser CLI command. The browser is driven from the terminal by running `hive-browser <command> ... --json` via terminal_exec — not via MCP tools. Teaches the browser lifecycle rules (the bridge attaches to the USER'S running Chrome — never kill or launch browser processes; timeouts are transport issues, not crashes), the screenshot + coordinate workflow (hive-browser interact with a fractional coordinate) that reaches shadow-DOM inputs selectors can't see, the viewport-fraction coordinate rule (not pixels), rich-text editor quirks ("send button stays disabled" failures), and CSP gotchas. Covers Chrome via CDP through the GCU Beeline extension.