terminal-pty-macos SKILL.md skillA

terminal-pty-macos 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-macos@git:20261003.6479ce9

Pins git:20261003.6479ce9 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-macos/SKILL.md
Versions recorded
5
Latest version
git:20261003.6479ce9, committed Oct 3, 2026
First version recorded
Oct 2, 2026
Size
4,791 bytes
Repository stars
14
License
a license file GitHub does not identify

Use before changing or debugging clud's terminal/PTY path on macOS (POSIX PTY, raw mode, libc termios/openpty type differences from Linux, escape sequences, terminal restore). Covers what differs from Linux, how to catch macOS-only compile errors early, and when a macOS platform implementation change needs ci-full; shared business logic calling platform code stays on routine CI.

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 macOS

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).
The pump, escape gate, stream scanners, signal handling and terminal
restore are the **same POSIX code as Linux**. Read
[terminal-pty-linux](../terminal-pty-linux/SKILL.md) for those. This page
lists only what differs on macOS.

## What is different on macOS

- **No local execution.** There is no local macOS machine, and `act` cannot
  run macOS jobs. Any runtime behaviour can only be observed on GitHub's
  hosted macOS runners.
- **libc signatures and types differ from Linux.** Both of these were
  verified while #1707 carried a `libc::openpty` call; the current tree has
  none.
  - `libc::openpty` takes `*mut termios` and `*mut winsize` on macOS, but
    `*const` on Linux. Passing `std::ptr::null_mut()` compiles on both.
  - `libc::tcflag_t` is `u64` on macOS and `u32` on Linux. An `as` cast that
    is a no-op on one platform trips `clippy::unnecessary_cast` on the
    other. Prefer `From` / `try_from` or slice copies.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zackees/clud/terminal-pty-macos@sha256:8acc34ee363a2e08

The line at the top of this page pins the label git:20261003.6479ce9, 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_3vhzuki2f2vyfnqk.svg)](https://markdownregistry.com/a/art_3vhzuki2f2vyfnqk)

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.6479ce9 latest2026-10-03 6479ce9 4,791 BA view · diff
git:20261003.848d41a2026-10-03 848d41a 4,767 BA view · diff
git:20261003.73ccff32026-10-03 73ccff3 4,172 BA view · diff
git:20261002.64231782026-10-02 6423178 4,197 BA view · diff
git:20261002.9da7c7d2026-10-02 9da7c7d 4,185 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 (4791 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_3vhzuki2f2vyfnqk
GET https://markdownregistry.com/api/v1/resolve?ref=zackees/clud/terminal-pty-macos
GET https://markdownregistry.com/api/v1/blob/8acc34ee363a2e08d2c13082a4309de00a6cb4e7b5ad58fb95d936e479572165

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-linux SKILL.md skill
zackees/clud · .claude/skills/terminal-pty-linux/SKILL.md · Use before changing or debugging clud's terminal/PTY path on Linux (POSIX PTY, byte-stream stdin, crossterm raw mode…
git:20261003.6fc7f59 · 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.