# turnstile

> A machine-wide, memory-aware gate for builds and tests on macOS.

## Docs

- [turnstile](https://turnstile.marginalutility.dev/index.md): A machine-wide, memory-aware gate for builds and tests on macOS.
- [Install](https://turnstile.marginalutility.dev/install.md): Install turnstile with Homebrew, a release binary, or from source.
- [Agents and people](https://turnstile.marginalutility.dev/agents.md): How turnstile tells an agent's shell from yours, and what changes when it does.
- [Your Mac as a CI runner](https://turnstile.marginalutility.dev/local-ci.md): Run CI on the machine you work on, without it fighting your agents or you.
- [How it works](https://turnstile.marginalutility.dev/how-it-works.md): Shims, the daemon, and what gets gated.
- [Scheduling](https://turnstile.marginalutility.dev/scheduling.md): How turnstile decides when a queued job starts.
- [Memory pressure](https://turnstile.marginalutility.dev/pressure.md): What turnstile does when memory gets tight.
- [Limits](https://turnstile.marginalutility.dev/limits.md): What turnstile can't see or gate.
- [Alternatives](https://turnstile.marginalutility.dev/alternatives.md): How turnstile relates to worktrees, containers, cloud agents, and the job flags you already have.
- [Worktrees and agent orchestrators](https://turnstile.marginalutility.dev/alternatives/orchestrators.md): Conductor, Claude Squad, Vibe Kanban, Crystal, and plain git worktrees, next to turnstile.
- [Containers and VMs](https://turnstile.marginalutility.dev/alternatives/containers.md): Sculptor, devcontainers, Docker, and OrbStack, next to turnstile.
- [Cloud agents](https://turnstile.marginalutility.dev/alternatives/cloud.md): Claude Code on the web, Codex Cloud, and hosted runners, next to turnstile.
- [Shell tools](https://turnstile.marginalutility.dev/alternatives/shell-tools.md): sem, niceload, flock, nice, taskpolicy, and make -l, next to turnstile.
- [Build tool limits](https://turnstile.marginalutility.dev/alternatives/build-tools.md): Job flags, worker counts, and Bazel's resource model, next to turnstile.
- [Commands](https://turnstile.marginalutility.dev/commands.md): Every turnstile subcommand.
- [Configuration](https://turnstile.marginalutility.dev/configuration.md): Machine settings, per-project rules, and throttling.
- [Environment variables](https://turnstile.marginalutility.dev/environment.md): Variables that change how turnstile behaves in a shell.
- [Exit codes](https://turnstile.marginalutility.dev/exit-codes.md): The exit codes turnstile adds on top of the tool's own.
- [Menu bar app](https://turnstile.marginalutility.dev/menu-bar-app.md): Watch and control the queue without a terminal.
- [Troubleshooting](https://turnstile.marginalutility.dev/troubleshooting.md): Fixes for common problems.
- [Development](https://turnstile.marginalutility.dev/development.md): Build, test, and release turnstile.