Hive Terminal: PTY Sessions
Drives interactive terminal sessions and REPLs while preserving state across calls.
Test report
- Verdict
- Works with setup
- Score
- Tested
- Jul 12, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · a59fa2c
Hard dependency, undisclosed: SKILL.md is a usage manual for terminal_pty_open/terminal_pty_run/terminal_pty_close tools that only exist when the Hive queen-agent's FastMCP terminal-tools server is running — they are absent from plain Claude Code and the skill never says so, reading as if the tools are simply available. Its own worked example is also buggy: the documented expect=r">>>\s*$" pattern for entering the python3 REPL never matches because trailing ANSI escape codes after the prompt defeat the $ anchor (timed out every run). Install itself was clean (git clone + cp verbatim, frontmatter parses, no missing files); an A/B against a no-skill base — both driving the repo's stdlib PtySession — produced identical correct results (cwd survived the REPL excursion, REPL computed 42, clean close), and the base actually sidestepped the buggy expect example, so the skill's conventions added no measurable correctness.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 4/5
- Output vs. baseline 5/10
- Docs & honesty 2/5
What Hive Terminal: PTY Sessions does
Use when you need state across calls — building env vars, navigating with cd, driving REPLs (python -i, mysql, psql, node), or responding to interactive prompts (sudo password, ssh host-key confirmation, mysql connection). Teaches the prompt-sentinel exec pattern (default mode), raw I/O for REPLs (raw_send=True then read_only=True), the one-in-flight-per-session rule, and the…
How to install Hive Terminal: PTY Sessions
git clone https://github.com/aden-hive/hive
cd hive
mkdir -p ~/.claude/skills
cp -r core/framework/skills/_preset_skills/terminal-tools-pty-sessions ~/.claude/skills/hive-terminal-tools-pty-sessions
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Hive Terminal: PTY Sessions
-
/hive-terminal-tools-pty-sessionsDrives interactive terminal sessions and REPLs while preserving state across calls.
It also activates on plain-language prompts like these:
-
Open a Python REPL session and run these commands -
SSH into this host and respond to the key prompt -
Keep a psql session open across multiple queries
Frequently asked questions
- Is the Hive Terminal: PTY Sessions skill free?
- Yes. The skill itself is free from aden-hive/hive. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Hive Terminal: PTY Sessions work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 12, 2026. Verdict: Works with setup. Hard dependency, undisclosed: SKILL.md is a usage manual for terminal_pty_open/terminal_pty_run/terminal_pty_close tools that only exist when the Hive queen-agent's FastMCP terminal-tools server is running — they are absent from plain Claude Code and the skill never says so, reading as if the tools are simply available. Its own worked example is also buggy: the documented expect=r">>>\s*$" pattern for entering the python3 REPL never matches because trailing ANSI escape codes after the prompt defeat the $ anchor (timed out every run). Install itself was clean (git clone + cp verbatim, frontmatter parses, no missing files); an A/B against a no-skill base — both driving the repo's stdlib PtySession — produced identical correct results (cwd survived the REPL excursion, REPL computed 42, clean close), and the base actually sidestepped the buggy expect example, so the skill's conventions added no measurable correctness.
- What is the Hive Terminal: PTY Sessions SkillProof Score?
- 6.4/10 — installs cleanly 5/5, triggers reliably 4/5, output vs. baseline 5/10, docs & honesty 2/5.
- How do I install Hive Terminal: PTY Sessions?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Hive Terminal: PTY Sessions with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.