# smartcloud

> Repository automation and policy for GitHub, configured in one YAML file.

- [Introduction](https://smartcloud.mintlify.app/introduction.md): What smartcloud does, and how to run it in a repository.
- [Configuration](https://smartcloud.mintlify.app/configuration.md): The config file, its sections, and how shared presets lock what they set.
- [Conditions](https://smartcloud.mintlify.app/conditions.md): The condition language used by labelling, conventions, reviews and stale exemptions.
- [Conventions](https://smartcloud.mintlify.app/features/conventions.md): Title and description conventions for pull requests and issues.
- [Commits](https://smartcloud.mintlify.app/features/commits.md): DCO sign-off and AI attribution rules for the commits on a pull request.
- [Disclosure](https://smartcloud.mintlify.app/features/disclosure.md): The AI disclosure a pull request description must carry.
- [Reviews](https://smartcloud.mintlify.app/features/reviews.md): The maintainer review gate, requested reviewers and automatic approval.
- [Labels](https://smartcloud.mintlify.app/features/labels.md): Keep repository labels in line with the config, and apply them by condition.
- [Stale](https://smartcloud.mintlify.app/features/stale.md): Mark inactive issues and pull requests stale, then abandon or close them.
- [Settings](https://smartcloud.mintlify.app/features/settings.md): Repository settings as code: merging, features, security, the default branch ruleset, environments, Actions, access, webhooks, Pages and variables.
- [Sync](https://smartcloud.mintlify.app/features/sync.md): Sync files from a template directory in another repository, and protect synced content.
- [Reporting](https://smartcloud.mintlify.app/reporting.md): Where findings and changes appear: check runs, one comment, the job summary and annotations.
- [CLI](https://smartcloud.mintlify.app/cli.md): Validate and migrate smartcloud configs from the command line.
- [Migrating from v1](https://smartcloud.mintlify.app/migration.md): Convert a v1 .github/config.json to a v2 .github/smartcloud.yml.
- [MCP server](https://smartcloud.mintlify.app/mcp-server.md): Let AI assistants validate, explain and dry-run smartcloud configs through the Model Context Protocol.
- [Telemetry](https://smartcloud.mintlify.app/telemetry.md): What smartcloud sends to PostHog, what it never sends, how to turn it off, and how feature flags work.
- [Releasing](https://smartcloud.mintlify.app/releasing.md): How a smartcloud release is cut with Nx release, and how the first v2 release differs.
- [Configuration reference](https://smartcloud.mintlify.app/reference/configuration.md): Every key smartcloud accepts in .github/smartcloud.yml, generated from the JSON Schema.