git:20261012.89507e4 to git:20261012.820bcba

# sleight

A Claude Code plugin (MCP server, relay and mod) that drives Mac apps through the computer-use engine

bundled with the ChatGPT desktop app. See README.md for how it fits together.

## Checks

Run `npm run check` before committing: relay tests, `claude plugin validate`, and the mod's tests.

`npm run typecheck` needs the types Claude Code writes when it loads the mod.

`npm run check` waits while `/tmp/sleight-hold` exists, which marks another project's timed window

on this Mac (`SLEIGHT_IGNORE_HOLD=1` skips the wait). Live probes stop while it exists too.

On a heavily loaded Mac, two tests can fail on timing: `tests/preapproved-process.test.mjs` (timeout

collects a process group) and the stuck-probe restart in app-health. At load averages of 102 to 107

(2026-10-10), the first failed 1 of 3 runs alone and both failed in a full check. At load 23 the

## Writing

Docs, skills, commit messages and anything else people read go through the same bar:

- Run `npm run lint:prose` (Vale with the ai-tells pack) on any doc you change, and fix what it flags

rather than suppressing it. Add files to the script as the docs grow.

- For a larger rewrite, use the humanizer skill in `.claude/skills/humanizer/`.

- State facts we measured, with the number. Write "12/12 on four tasks", not "works reliably".

- Put limitations in `docs/known-problems.md` as soon as we find them, and say plainly what we don't know.

- Use commas, periods and parentheses where an em dash would go. Start list items with the point

itself, without a bold label. State a claim directly, without first denying something nobody said.

- Write less. The plugin is about 5,700 lines of code (2026-10-09), and the docs shouldn't outweigh it.