2026-07-21 16:01:00 +08:00
# pty/ — persistent PTY capability family
2026-07-26 05:03:53 +08:00
English | [中文 ](README.zh.md )
2026-08-04 00:54:19 +08:00
This family provides persistent, owner-scoped pseudo-terminal sessions for interactive or stateful terminal work. It complements one-shot bash execution.
2026-07-21 16:01:00 +08:00
| Package | Role | ctx key |
|---|---|---|
2026-08-04 00:54:19 +08:00
| [`pty/` ](pty/README.md ) | Defines the PTY service and session lifecycle | `ctx.pty` |
| [`pty-local/` ](pty-local/README.md ) | Provides local persistent terminal sessions | registers on `ctx.pty` |
| [`tool-pty/` ](tool-pty/README.md ) | Exposes PTY session operations to the model | registers on `ctx.tools` |
| [`tool-bash-persistent/` ](tool-bash-persistent/README.md ) | Exposes a reusable PTY-backed bash tool | registers on `ctx.tools` |
2026-07-21 16:01:00 +08:00
2026-08-04 00:54:19 +08:00
The [persistent PTY decision ](../../.agents/notes/implemented/feature/2026-07-16-persistent-pty-sessions.md ) records the family boundary.