- name
SKILL.md
Tệp skill vẫn nằm trong kho mã của nhà phát hành.
Dán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add aden-hive/hive --skill terminal-tools-troubleshooting -a cursor -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add aden-hive/hive --skill terminal-tools-troubleshooting -a claude-code -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add aden-hive/hive --skill terminal-tools-troubleshooting -a codex -yDán lệnh đã sao chép vào terminal. Lệnh sẽ cài đặt tệp SKILL.md này vào agent đó.
npx skills add aden-hive/hive --skill terminal-tools-troubleshooting -a grok -yGửi tin nhắn đã sao chép trong cuộc trò chuyện Grok Bot. Bot sẽ lấy tệp SKILL.md này từ GitHub và thêm vào bộ skill mà mọi Bot của bạn dùng chung.
Install this skill: https://github.com/aden-hive/hive/tree/HEAD/core/framework/skills/_preset_skills/terminal-tools-troubleshootingTừ nhà phát hành
Recipes for surprising results. Match the symptom to the section.
stdout despite the command "should have" produced outputPossible causes:
stderr in the envelope (or use merge_stderr=True for jobs).max_output_kb is too small. Check stdout_truncated_bytes > 0. Bump max_output_kb or paginate via output_handle.silent flags, no matches).> /dev/null, redirected via 2>&1).stdbuf -oL (line-buffered) or unbuffer to the command.exit_code: nulloutput_handle returned expired: true5-minute TTL. Either (a) you waited too long, or (b) the store evicted it under memory pressure (64 MB total cap, LRU eviction). Re-run the command.
To reduce risk: paginate the handle as soon as you receive it, or use terminal_job_* for huge outputs (4 MB ring buffer with offsets — no expiry).
JobLimitExceededTERMINAL_TOOLS_MAX_JOBS (default 32) hit. Either:
terminal_job_logs(wait_until_exit=True))terminal_job_manage(action="list") to see what's running, then signal_term the abandoned onesA terminal_pty_run was issued while another _run is in flight on the same session. PTY sessions are single-threaded conversations. Wait for the prior call to return, or open a second session.
TERMINAL_TOOLS_MAX_PTY (default 8) hit. Close idle sessions (terminal_pty_close). Idle reaping is lazy; force it by opening — no, actually, opening throws when the cap is hit. Just close manually.
warning is set, the command workedInformational only. The pattern matched (e.g. rm -rf literally appears, or git push --force was used). The command ran. The warning is your "did I mean to do that?" prompt — verify the side effect was intended before continuing.
semantic_status: "ok" but exit_code: 1Working as designed. Some commands use exit 1 for legitimate non-error states:
grep / rg exit 1 when no matches foundfind exit 1 when some directories were unreadable (typical on /proc, etc.)diff exit 1 when files differtest / [ exit 1 when condition is falseThe semantic_message field explains. Trust semantic_status, not raw exit_code.
semantic_status: "error" but exit_code: 0Shouldn't happen. If it does, file a bug.
truncated_bytes_dropped > 0 in terminal_job_logsYour since_offset was older than the ring buffer's floor — bytes evicted before you could read them. Either:
merge_stderr=True (single 4 MB ring instead of 4 MB × 2)next_offsetterminal_pty_open succeeds but the first _run times outThe session may not have produced its first prompt sentinel within the 2-second startup window. Try:
terminal_pty_run(sid, read_only=True, timeout_sec=2) to drain whatever's accumulatedterminal_pty_run(sid, command="true")) to force a prompt cycleCould also indicate the bash process died at startup — terminal_pty_run(sid, ...) would then return "session has exited".
shell="/bin/zsh" returned an errorBy design. terminal-tools is bash-only on POSIX. Use shell=True (default /bin/bash) or omit shell= to exec directly.
shell=True is interpreted differently than expectedBash, not zsh, semantics. **/* doesn't recurse without shopt -s globstar; =cmd expansion doesn't work; arrays use arr[idx] not ${arr[idx]} differently than zsh. When in doubt, the foundational skill's "bash, not zsh" section is the canonical statement.
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", w
---name: hive.terminal-tools-troubleshootingdescription: Read when a terminal-tools call returned something surprising — empty stdout despite no error, exit_code is…---# core/framework/skills/_preset_skills/terminal-tools-troubleshooting/SKILL.mdTổng quan
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.
Câu hỏi thường gặp
Tải core/framework/skills/_preset_skills/terminal-tools-troubleshooting/SKILL.md từ nhà phát hành, hoặc sao chép đường dẫn và mở kho mã. PlugMCP chỉ liệt kê skill và không lưu trữ tệp này.
Nhà phát hành duy trì nó tại https://github.com/aden-hive/hive.
Claude, Cursor, Codex và Grok Build có thể đọc tệp SKILL.md mà bạn thêm từ kho mã của nhà phát hành. Grok Bot cài đặt skill khi bạn gửi liên kết thư mục GitHub của skill trong cuộc trò chuyện.