# Irrigator

> Irrigator is an MIT-licensed local execution engine for durable agent workflows, with a CLI for macOS, Linux and Windows via WSL plus an optional native macOS terminal.

Plans define task identities, dependencies, outputs, and acceptance checks. The runtime records attempts and accepted artifacts so users can inspect, recover, or resume work. Claude Code and Codex plugins share the same Markdown skills and separately installed CLI. Windows support is planned and currently unsupported.

The homepage demonstrates a recorded mock run; it does not run agents or make model calls. Installation currently uses a source build. Real providers require explicit configuration and spending authorization. Unknown provider effects require an explicit recovery decision.

## Start here

- [README](https://github.com/grainulation/irrigator/blob/main/README.md): project overview and source installation.
- [First run](https://github.com/grainulation/irrigator/blob/main/docs/first-run.md): mock workflow, provider selection, and recovery.
- [Documentation index](https://github.com/grainulation/irrigator/blob/main/docs/index.md): all guides.
- [Host integration](https://github.com/grainulation/irrigator/blob/main/docs/host-integration.md): agent plugins and skills.
- [Execution profiles](https://github.com/grainulation/irrigator/blob/main/docs/execution-profiles.md): providers, models, authority, and budgets.

## Contracts and maintenance

- [Architecture](https://github.com/grainulation/irrigator/blob/main/docs/architecture.md): execution and storage boundaries.
- [Security](https://github.com/grainulation/irrigator/blob/main/SECURITY.md): trust model and reporting.
- [Platform support](https://github.com/grainulation/irrigator/blob/main/docs/platform-support.md): verified runtime and app scope.
- [Contributing](https://github.com/grainulation/irrigator/blob/main/CONTRIBUTING.md): change and verification requirements.
- [Changelog](https://github.com/grainulation/irrigator/blob/main/CHANGELOG.md): compatibility changes.

For installed command discovery use `irrigator help --json`. Follow the versioned plan and worker contracts in the checkout; this discovery index is not a replacement for them.

Repository and source installation currently require access to the private Grainulation repository. Public binary downloads are not offered by this site.