Run your first capsule

You can run a capsule directly from a supported repository URL.

Install Ato

curl -fsSL https://ato.run/install.sh | sh

Confirm the CLI is available:

ato --version

Run a repository

ato run github.com/owner/repository

Ato detects the repository, resolves its execution contract, and asks for any required permissions before starting it.

Declare a project

Add a capsule.toml when a repository needs an explicit execution contract. Keep runtime behavior simple: validation and dependency resolution belong at build time, while runtime consumes the resolved configuration.

Return to the documentation overview.