# spotexec (sx)

> Offload tests, typechecks, linters, E2E suites, and builds from local git worktrees to an SSH box or scale-to-zero AWS Spot fleet — with Git-blob delta sync, lockfile caches, 3-way safe write-back, and zero cloud control plane.

Every page on this site is available as clean Markdown by appending `.md` (or `/index.md` for the root page).

## Overview
- [Home / Overview](/index.md): High-level summary, why parallel coding agents exhaust local RAM, install, and 3-step quickstart.
- [Full Concatenated Manual](/llms-full.txt): Every SpotExec documentation page combined in a single plain-text Markdown file.

## Documentation
- [Introduction & Quickstart](/docs.md): What spotexec (sx) does, why parallel AI coding agents exhaust laptop memory, and how to install and run your first remote command.
- [Setting Up Machines](/docs/setup.md): Configure SSH boxes and scale-to-zero AWS Spot fleets with spotexec setup, provision multiple machines over SSH, and manage per-machine IAM keys.
- [Running Commands & Write-back](/docs/running.md): Run flags, runner environment variables, exit codes, 3-way content-ID write-back safety, and pulling gitignored build or coverage artifacts.
- [Coding Agents & Hooks](/docs/agents.md): Transparently offload heavy test, typecheck, and lint runs from Claude Code and Codex worktrees using hooks, load thresholds, and NDJSON events.
- [Containers, Caches & Baked Images](/docs/environments.md): Run commands inside content-addressed project Dockerfiles, hydrate lockfile-keyed dependency caches via reflink and S3, and bake fast-boot AMIs.
- [AWS Spot Fleet Guide](/docs/aws.md): Sign-in methods, least-privilege IAM policy, regions, Spot vCPU quotas, VPC networking, cost guardrails, and the 6-stage life of a Spot VM.
- [Scaling, Slots & Pool Manager](/docs/scaling.md): Oldest-first slot bin-packing, fair local queueing, $SPOTEXEC_CPUS worker sizing, and the optional local pool manager daemon.
- [Architecture & Security Model](/docs/architecture.md): How spotexec coordinates over SSH ControlMaster and cloud-init watchdogs with zero cloud control plane, strict trust boundaries, and known limits.
- [Configuration Reference](/docs/configuration.md): Complete key-by-key reference for global ~/.config/spotexec/config.toml, committed .spotexec.toml, tasks, hooks, and project-defined fleets.
- [CLI & File Reference](/docs/reference.md): Every spotexec and sx command, subcommand, and local or remote state file path in one concise reference.
- [Operations & Troubleshooting](/docs/troubleshooting.md): Day-2 operations, diagnosing bootstrap or capacity errors, handling write-back conflicts, unlocking wedged slots, and local Spot simulation.