Persistent PTY Sessions

Persistent PTY Sessions is an Automation skill for Claude Code, published by aden-hive in hive.

10.9K stars5.7K forkson aden-hive/hiveAdded 2026/08/15Repository updated 2026/08/13

agentagent-frameworkagent-skillsanthropicautomationautonomous-agentsclaudeharnessharness-engineeringhuman-in-the-loopopenaipythonself-hostedself-improving

Install in seconds

Install Persistent PTY Sessions

Copy Persistent PTY Sessions into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/aden-hive/hive/tree/main/core/framework/skills/_preset_skills/terminal-tools-pty-sessions ~/.claude/skills/terminal-tools-pty-sessions

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/aden-hive/hive.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: core/framework/skills/_preset_skills/terminal-tools-pty-sessions/SKILL.md in aden-hive/hive
Installs to: ~/.claude/skills/terminal-tools-pty-sessions
Collection: One of 24 skills cataloged from this repository
Category: Automation — 1523 skills

What Persistent PTY Sessions does

Persistent PTY Sessions manages interactive terminal sessions for stateful command execution, REPLs, and interactive prompts like sudo or SSH. Use it when you need state to persist across calls or drive a program that requires a real terminal.

Persistent PTY Sessions is cataloged under Automation on DirSkills. Persistent PTY Sessions comes from a repository tagged agent, agent-framework, agent-skills, anthropic and automation.

Documentation

README

Excerpt

Persistent PTY sessions

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:

You need state to persist across calls (cd, env vars, sourced scripts)
You're driving a REPL (python -i, mysql, psql, node, irb)
A program demands an interactive prompt (sudo, ssh, npm login, gh auth login)

For everything else, terminal_exec is simpler. Sessions cost more (per-session bash process, ring buffer, idle-reaping bookkeeping) and have a hard cap (TERMINAL_TOOLS_MAX_PTY, default 8).

Why PTY (and not subprocess pipes)

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Persistent PTY Sessions

What else does aden-hive publish alongside Persistent PTY Sessions?
Persistent PTY Sessions is one of 24 skills that DirSkills catalogs from aden-hive/hive, the repository it ships in. Its siblings there include Background Job Control, Browser Edge Cases and Chart Creation Foundations. Each one is a separate skill with its own page in this directory, installs the same way Persistent PTY Sessions does, and is maintained by aden-hive in that same repository. The rest of the collection is listed on the aden-hive/hive page.
How does Persistent PTY Sessions compare to other Automation skills?
Persistent PTY Sessions ranks #162 by stars among the 1523 Automation skills in this catalog. The most-starred ones next to it are Autonomous Loops, Autonomous Agent Harness and Automation Audit Ops. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Persistent PTY Sessions against them. Open each page to compare what they document and how they install.