terminal-pty-linux SKILL.md skillA

terminal-pty-linux from zackees/clud is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zackees/clud/terminal-pty-linux@git:20261003.6fc7f59

Pins git:20261003.6fc7f59 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zackees/clud
Path
.claude/skills/terminal-pty-linux/SKILL.md
Versions recorded
5
Latest version
git:20261003.6fc7f59, committed Oct 3, 2026
First version recorded
Oct 2, 2026
Size
6,743 bytes
Repository stars
14
License
a license file GitHub does not identify

Use before changing or debugging clud's terminal/PTY path on Linux (POSIX PTY, byte-stream stdin, crossterm raw mode and OPOST, SIGWINCH resize, SIGINT/SIGTERM/SIGHUP handling, escape sequences, terminal restore). Covers the files to read, the invariants, full local validation through bosn act, and clippy pitfalls specific to libc types.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Terminal / PTY on Linux

Shared facts (data flow, the three invariants, test tiers, act rules, CI
labels) are in
[docs/architecture/terminal-pty.md](../../../docs/architecture/terminal-pty.md).
Read that first. This page lists only what differs on Linux. macOS shares
this POSIX code; see [terminal-pty-macos](../terminal-pty-macos/SKILL.md).

## What is different on POSIX

- **PTY.** The PTY is running-process's `NativePtyProcess`. Never spawn
  through `std::process` (see CLAUDE.md).
- **Stdin.** Input comes from a byte-stream stdin reader, not a console
  event reader. There is no `extra_rx` keyboard source, and no Backspace or
  Shift+Enter rewriting.
- **Raw mode** is crossterm's `enable_raw_mode` inside
  `RawTerminalGuard::enter`, which clears `OPOST`. With `OPOST` cleared, a
  bare `\n` moves down without returning to column 0, so text walks
  diagonally. Never hand-roll raw mode or terminal writes in a selector; use
  `selector::run`
  ([DD-073](../../../docs/DESIGN_DECISIONS.md#dd-073-every-inline-selector-renders-through-one-component),
  guard test `migrated_selectors_never_drive_the_terminal_themselves`,
  `crates/clud-bin/src/selector.rs:994`).
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zackees/clud/terminal-pty-linux@sha256:74687dc7a665b637

The line at the top of this page pins the label git:20261003.6fc7f59, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6pcmqzm2ivekyqn4.svg)](https://markdownregistry.com/a/art_6pcmqzm2ivekyqn4)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 2, 2026 and Oct 3, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261003.6fc7f59 latest2026-10-03 6fc7f59 6,743 BA view · diff
git:20261003.6479ce92026-10-03 6479ce9 6,736 BA view · diff
git:20261003.5ee40592026-10-03 5ee4059 6,679 BA view · diff
git:20261003.73ccff32026-10-03 73ccff3 6,221 BA view · diff
git:20261002.9da7c7d2026-10-02 9da7c7d 6,361 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6743 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

zackees/clud · 14 stars · license a license file GitHub does not identify · pushed 2026-10-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6pcmqzm2ivekyqn4
GET https://markdownregistry.com/api/v1/resolve?ref=zackees/clud/terminal-pty-linux
GET https://markdownregistry.com/api/v1/blob/74687dc7a665b63784c18e5f1e46b4531f19fe3e85cb71cac741cff266c0bf23

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from zackees/clud

session-control SKILL.md skill
zackees/clud · .claude/skills/session-control/SKILL.md · Use when adding or changing a clud "session control" (a chat or agent control) — a switch only the user can turn that…
git:20261016.78627d9 · audit A · 14 stars
terminal-pty-macos SKILL.md skill
zackees/clud · .claude/skills/terminal-pty-macos/SKILL.md · Use before changing or debugging clud's terminal/PTY path on macOS (POSIX PTY, raw mode, libc termios/openpty type…
git:20261003.6479ce9 · audit A · 14 stars
terminal-pty-windows SKILL.md skill
zackees/clud · .claude/skills/terminal-pty-windows/SKILL.md · Use before changing or debugging clud's terminal/PTY path on Windows (ConPTY, the native ReadConsoleInputW reader, VT…
git:20261016.4c2ca20 · audit A · 14 stars
AGENTS.md AGENTS.md file
zackees/clud · AGENTS.md
git:20260927.57298cd · audit A · 14 stars
CLAUDE.md CLAUDE.md file
zackees/clud · CLAUDE.md
git:20261021.aa4d57b · audit A · 14 stars
clud-bosn SKILL.md skill
zackees/clud · crates/clud-bin/assets/skills/clud-bosn/SKILL.md · Run repeated local Docker builds under bosn so the loop stops filling the disk.
git:20261002.92ede28 · audit A · 14 stars
clud-docker-linux-build SKILL.md skill
zackees/clud · crates/clud-bin/assets/skills/clud-docker-linux-build/SKILL.md · Spin up a fast Linux build container for a Rust + soldr + zccache, Python (uv), or C++ (CMake + ccache) project using…
git:20260927.9e09ed0 · audit A · 14 stars
clud-docker-mac-x86 SKILL.md skill
zackees/clud · crates/clud-bin/assets/skills/clud-docker-mac-x86/SKILL.md · Run Intel macOS builds and tests locally inside dockur/macos when the host qualifies, instead of waiting for the GitHub…
git:20260619.8ecf927 · audit A · 14 stars
clud-docker-recover SKILL.md skill
zackees/clud · crates/clud-bin/assets/skills/clud-docker-recover/SKILL.md · Diagnose and recover a wedged Docker Desktop, missing engine pipe/socket, stopped or failed WSL distro, backing-volume…
git:20261001.ed53bdb · audit A · 14 stars
clud-docker-rust-app-dev SKILL.md skill
zackees/clud · crates/clud-bin/assets/skills/clud-docker-rust-app-dev/SKILL.md · Build a Rust app inside Docker for development iteration, using fast incremental cargo builds via named volumes for…
git:20260927.9e09ed0 · audit A · 14 stars
clud-extern-repos SKILL.md skill
zackees/clud · crates/clud-bin/assets/skills/clud-extern-repos/SKILL.md · Coordinate dependent cross-repo changes using a sister checkout directory beside the repo.
git:20260924.d5a5002 · audit A · 14 stars
clud-fix-quick SKILL.md skill
zackees/clud · crates/clud-bin/assets/skills/clud-fix-quick/SKILL.md · Local-first speed mode. Edits in place on the current branch, runs lint + targeted test + /clud-review on source-code…
git:20261004.eb3f22e · audit A · 14 stars

Every file in zackees/clud

Browse by kind, by grade A, or by owner.