Overview
hive.terminal-tools-pty-sessions is an open-source backend skill for Claude Code and compatible agents, published by aden-hive. Its author describes it as: “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 connect…”. 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-pty-sessions`.
What hive.terminal-tools-pty-sessions does
PTY sessions are how you talk to interactive programs — programs that detect a terminal (`isatty()`) and behave differently when they don't see one. Use a session when:
Best for
What’s inside
The SKILL.md for hive.terminal-tools-pty-sessions is organised into these sections:
- Why PTY (and not subprocess pipes)
- Bash on macOS — by deliberate policy
- Three modes of terminalptyrun
- 1. Default: send command, wait for prompt sentinel
- 2. rawsend: send raw input, no waiting
- 3. readonly: drain currently-buffered output
- Custom prompt detection (expect)
- Always close
- Common patterns
- Stateful navigation
- Python REPL
- ssh with host-key prompt
Installation
Add hive.terminal-tools-pty-sessions to your agent with:
git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-pty-sessionsReview 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-pty-sessions 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
Topics
Frequently asked questions
- What does hive.terminal-tools-pty-sessions do?
- 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 close-or-leak-against-the-cap discipline. Bash on macOS — never zsh; explicit shell=/bin/zsh is rejected. Read before calling terminal_pty_open.
- How do I install hive.terminal-tools-pty-sessions?
- Run git clone https://github.com/aden-hive/hive ~/.claude/skills/terminal-tools-pty-sessions in your agent, then reload your skills. Review the source at https://github.com/aden-hive/hive before installing.
- Is hive.terminal-tools-pty-sessions free to use?
- Yes. hive.terminal-tools-pty-sessions 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-pty-sessions come from?
- hive.terminal-tools-pty-sessions 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.
