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-job-control
hive.terminal-tools-job-control is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. Its author describes it as: “Use when launching anything that runs longer than a minute, anything that streams logs, anything you want to keep running while doing other work — or when terminal_exec auto-backgrounded on you and returned a job_id.…”. 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-job-control`.
What hive.terminal-tools-job-control does
Background jobs are how you do things that take time without blocking your conversation. Three tools cover the surface: `terminal_job_start`, `terminal_job_logs`, `terminal_job_manage`.
Installation
Add hive.terminal-tools-job-control to your agent with:
git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-job-control Always 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-job-control is organised into these sections:
- When to use a job
- Lifecycle
- Offset bookkeeping — the only rule that matters
- mergestderr — interleaved or separate
- Signal escalation
- Stdin
- Take-over: when terminalexec auto-backgrounds
- Hard rules
When to use it
Reach for hive.terminal-tools-job-control 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-job-control do?
- Use when launching anything that runs longer than a minute, anything that streams logs, anything you want to keep running while doing other work — or when terminal_exec auto-backgrounded on you and returned a job_id. Teaches the start→poll→wait pattern with terminal_job_logs offset bookkeeping, the `wait_until_exit=True` blocking-poll idiom, the truncated_bytes_dropped resumption signal, the merge_stderr decision, the SIGINT→SIGTERM→SIGKILL escalation ladder via terminal_job_manage, and the hard rule that jobs die when the terminal-tools server restarts. Read before calling terminal_job_start, or right after terminal_exec auto-backgrounded.
- How do I install hive.terminal-tools-job-control?
- Run git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-job-control in your agent, then reload your skills. Review the source at https://github.com/aden-hive/hive before installing.
- Is hive.terminal-tools-job-control free to use?
- Yes. hive.terminal-tools-job-control 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-job-control come from?
- hive.terminal-tools-job-control 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.