CLAUDE.md git:20261012.820bcbaA

Immutable. This exact content never changes and is served at /api/v1/blob/b32e6bd0b7f038b8.

# 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
full check passed.

## 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.