🛠️
DevOpsPython

Terminal Tools Troubleshooting

by aden-hive

Terminal Tools Troubleshooting is a DevOps skill for Claude Code, published by aden-hive in hive.

10.9K stars5.7K forkson aden-hive/hiveAdded 2026/08/15Repository updated 2026/08/13
agentagent-frameworkagent-skillsanthropicautomationautonomous-agentsclaudeharnessharness-engineeringhuman-in-the-loopopenaipythonself-hostedself-improving
Install in seconds
Install Terminal Tools Troubleshooting
Copy Terminal Tools Troubleshooting into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/aden-hive/hive/tree/main/core/framework/skills/_preset_skills/terminal-tools-troubleshooting ~/.claude/skills/terminal-tools-troubleshooting

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/aden-hive/hive.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
core/framework/skills/_preset_skills/terminal-tools-troubleshooting/SKILL.md in aden-hive/hive
Installs to
~/.claude/skills/terminal-tools-troubleshooting
Collection
One of 24 skills cataloged from this repository
Category
DevOps798 skills

What Terminal Tools Troubleshooting does

Terminal Tools Troubleshooting provides diagnostic recipes for surprising terminal-tools results: empty stdout, null exit codes, expired handles, job/PTY limits, and semantic status mismatches. Use when a call returns something unexpected.

Terminal Tools Troubleshooting is cataloged under DevOps on DirSkills. Terminal Tools Troubleshooting comes from a repository tagged agent, agent-framework, agent-skills, anthropic and automation.

Documentation

README

Troubleshooting terminal-tools

Recipes for surprising results. Match the symptom to the section.

Empty stdout despite the command "should have" produced output

Possible causes:

  1. Output went to stderr instead. Check stderr in the envelope (or use merge_stderr=True for jobs).
  2. Output was fully truncated because max_output_kb is too small. Check stdout_truncated_bytes > 0. Bump max_output_kb or paginate via output_handle.
  3. Command produced no output (correct, just unexpected — silent flags, no matches).
  4. Pipeline issue: the last stage of a pipe ran but stdout went elsewhere (> /dev/null, redirected via 2>&1).
  5. Process is buffering its output and didn't flush before exit. Add stdbuf -oL (line-buffered) or unbuffer to the command.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Terminal Tools Troubleshooting

  • What else does aden-hive publish alongside Terminal Tools Troubleshooting?

    Terminal Tools Troubleshooting is one of 24 skills that DirSkills catalogs from aden-hive/hive, the repository it ships in. Its siblings there include Background Job Control, Browser Edge Cases and Chart Creation Foundations. Each one is a separate skill with its own page in this directory, installs the same way Terminal Tools Troubleshooting does, and is maintained by aden-hive in that same repository. The rest of the collection is listed on the aden-hive/hive page.

  • How does Terminal Tools Troubleshooting compare to other DevOps skills?

    Terminal Tools Troubleshooting ranks #108 by stars among the 798 DevOps skills in this catalog. The most-starred ones next to it are Backend Patterns, API Connector Builder and Migration. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Terminal Tools Troubleshooting against them. Open each page to compare what they document and how they install.

More from aden-hive/hive

Terminal Tools Troubleshooting is one of 24 skills cataloged on DirSkills from aden-hive/hive.

See all 24 skills
2w ago

Background Job Control

Background Job Control manages long-running terminal jobs using start, poll, wait, and signal tools. Use it before launching builds, deploys, streaming logs, or taking over auto-backgrounded processes from terminal_exec.
Automation
10.9K5.7K
🔍
2w ago

Browser Edge Cases

Browser Edge Cases provides a standard operating procedure for debugging browser automation failures on complex websites. Use it when browser tools fail on LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
Automation
10.9K5.7K
📊
2w ago

Chart Creation Foundations

Chart Creation Foundations teaches the one-tool embedding contract for rendering BI/financial-grade ECharts and Mermaid charts that appear live in chat and save as high-DPI PNGs. Use it whenever chart_* tools are available to avoid chartjunk and missing downloads.
Data
10.9K5.7K
📋
2w ago

Colony Progress Tracker

Colony Progress Tracker claims tasks, records step progress, and verifies SOP gates in a shared SQLite queue. Use when your spawn message includes db_path and colony_id fields.
Automation
10.9K5.7K
🧠
2w ago

Context Preservation

Context Preservation proactively extracts critical values from tool results into working notes before automatic context pruning destroys them. Use it when an agent must retain URLs, API fields, IDs, and analysis conclusions across long tasks.
AI Engineering
10.9K5.7K
🔁
2w ago

Error Recovery

Error Recovery guides an agent through a decision tree for tool call failures: retry transient errors once, fix and retry structural ones, or escalate if blocking. It switches tools after repeated failures and logs failed tasks to a database.
AI Engineering
10.9K5.7K