hive.terminal-tools-job-control

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.

by aden-hive 11k GitHub stars Apache-2.0 Updated Aug 13, 2026
hive.terminal-tools-job-control skill by aden-hive
hive.terminal-tools-job-control — Workflow skill by aden-hive

Overview

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`.

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

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

Review 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-job-control 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

aden-hive 25 skills in the catalog · GitHub profile ↗
View skills

Topics

Need a skill like this, tailored to your team?Build a custom skill →

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.

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.

11k GitHub stars Apache-2.0 Updated Aug 13, 2026 Free

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`.

11k GitHub stars Apache-2.0 Updated Aug 13, 2026 Free

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`.

11k GitHub stars Apache-2.0 Updated Aug 13, 2026 Free

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`.

11k GitHub stars Apache-2.0 Updated Aug 13, 2026 Free

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.

11k GitHub stars Apache-2.0 Updated Aug 13, 2026 Free