terminal-pty-macos SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

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

Install it, pinned
mdr add talos-hq/clud/terminal-pty-macos@git:20261023.9556b6b

Pins git:20261023.9556b6b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
talos-hq/clud
Path
.claude/skills/terminal-pty-macos/SKILL.md
Versions recorded
5
Latest version
git:20261023.9556b6b, committed Oct 23, 2026
First version recorded
Oct 2, 2026
Size
4,900 bytes
Repository stars
16
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-macos; 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 talos-hq/clud/terminal-pty-macos@sha256:4f68e47a9510876e

The line at the top of this page pins the label git:20261023.9556b6b, 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_h7xa3j2tcvdeuwo2.svg)](https://markdownregistry.com/a/art_h7xa3j2tcvdeuwo2)

1 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 23, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20261023.9556b6b latest2026-10-23 9556b6b 4,900 BA view · diff
git:20261003.6479ce92026-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

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 (4900 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

talos-hq/clud · 16 stars · license a license file GitHub does not identify · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_h7xa3j2tcvdeuwo2
GET https://markdownregistry.com/api/v1/resolve?ref=talos-hq/clud/terminal-pty-macos
GET https://markdownregistry.com/api/v1/blob/4f68e47a9510876e7b5fc11162c46d174976141c85f77f6487b6071833db38b8

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 talos-hq/clud

session-control SKILL.md skill
talos-hq/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 · 16 stars
terminal-pty-linux SKILL.md skill
talos-hq/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 · 16 stars
terminal-pty-windows SKILL.md skill
talos-hq/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 · 16 stars
AGENTS.md AGENTS.md file
talos-hq/clud · AGENTS.md
git:20260927.57298cd · audit A · 16 stars
CLAUDE.md CLAUDE.md file
talos-hq/clud · CLAUDE.md
git:20261101.68a70eb · audit A · 16 stars
clud-bosn SKILL.md skill
talos-hq/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:20261028.58c61d7 · audit A · 16 stars
clud-docker-linux-build SKILL.md skill
talos-hq/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:20261028.1d1ca1c · audit A · 16 stars
clud-docker-mac-x86 SKILL.md skill
talos-hq/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 · 16 stars
clud-docker-recover SKILL.md skill
talos-hq/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 · 16 stars
clud-docker-rust-app-dev SKILL.md skill
talos-hq/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:20261028.1d1ca1c · audit A · 16 stars
clud-extern-repos SKILL.md skill
talos-hq/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:20261028.1d1ca1c · audit A · 16 stars
clud-fix-quick SKILL.md skill
talos-hq/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:20261029.e109233 · audit A · 16 stars

Every file in talos-hq/clud

Other files named terminal-pty-macos

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:20261023.9556b6b · audit A · 17 stars

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