# missouri

> missouri runs end-to-end CLI tests as a graph of filesystem states connected by shell commands.

Each link below opens a page's Markdown twin. Diátaxis sections are Tutorials, How-to guides, Reference, and Optional; Optional holds explanation pages and may be skipped. Installation packages are Homebrew `cjohnhanson/tap/missouri`, crate `missouri`, PyPI `msri`, and npm `@cjohnhanson/msri`.


## Tutorials

- [Getting Started with Missouri](https://missouri.eng.rip/getting-started.md): Create your first state graph test suite

## How-to guides

- [How to write missouri tests as state graphs](https://missouri.eng.rip/writing-tests.md): How to model tests as state graphs with transitions, assertions, and services

## Reference

- [missouri CLI reference](https://missouri.eng.rip/cli-reference.md): Every command, argument, and flag of the missouri binary, generated from its definition
- [missouri configuration format](https://missouri.eng.rip/config-format.md): The missouri.yml fields, comparators, services, ignore file, bin directory, sandbox, and state graph model

## Optional

- [What is Missouri?](https://missouri.eng.rip/what-is-missouri.md): Why filesystem state graphs and how missouri's testing model works