# Count Patchula > Count Patchula is a dependency update bot for GitHub, written in Rust, and an alternative to Renovate. The binary is `patchula`. It opens one pull request per update, with regenerated lockfiles, release notes and security advisories, and is configured with a `patchula.pkl` file in Pkl. Every page is also served as Markdown: request its URL with `Accept: text/markdown`, or add `index.md` to it. A coding agent setting the Count up in a repository should follow the [agent setup instructions](https://raw.githubusercontent.com/sweepies/count-patchula/main/docs/agent-setup.md). - Start here - [Getting started](https://count-patchula.sweepy.dev/getting-started/index.md): Take one repository from nothing to its first update pull requests. - [Installation](https://count-patchula.sweepy.dev/installation/index.md): Install the patchula binary, and what the runner needs at run time. - [How it works](https://count-patchula.sweepy.dev/guide/how-it-works/index.md): What happens during a Count Patchula run, from reading repositories through the GitHub API to publishing verified commits and pull requests. - Configure - [Configuration](https://count-patchula.sweepy.dev/guide/configuration/index.md): Configure Count Patchula with patchula.pkl: where the config lives, sharing policy across repositories, defaults, rules and custom extractors. - [Release age and channels](https://count-patchula.sweepy.dev/guide/lookup-policy/index.md): How the Count picks the version to propose: update classes, the release-age wait, prereleases, ranges and Node release channels. - [Security advisories](https://count-patchula.sweepy.dev/guide/security/index.md): How the Count checks dependencies against OSV.dev, marks security updates, and checks container image rebuilds for fixed OS packages. - [Managers](https://count-patchula.sweepy.dev/guide/managers/index.md): Every package manager Count Patchula supports, the files each one reads, and the lockfiles it regenerates. - [Sources](https://count-patchula.sweepy.dev/guide/sources/index.md): Where Count Patchula looks up versions: npm, crates.io, the Go proxy, PyPI, container registries, Helm, Terraform, Maven and more. - [Versioning](https://count-patchula.sweepy.dev/guide/versioning/index.md): The version schemes Count Patchula understands (semver, Docker, PEP 440, Poetry and others) and how each sorts, matches and rewrites ranges. - Pull requests - [Branches and PRs](https://count-patchula.sweepy.dev/guide/pull-requests/index.md): Branch names, commits and PR bodies, what the Count owns in a description, closing PRs, limits, holds and repeat runs. - [Lockfiles](https://count-patchula.sweepy.dev/guide/lockfiles/index.md): How the Count regenerates lockfiles with each ecosystem's real tool, which tools cover which lockfiles, and what happens when one fails. - [Release notes](https://count-patchula.sweepy.dev/guide/release-notes/index.md): How update PRs gather release notes and changelogs for every version between the current and proposed one. - [Batching](https://count-patchula.sweepy.dev/guide/batch/index.md): Collect reviewed updates into one batch pull request by ticking a checkbox, then merge them together. - [Dependency dashboard](https://count-patchula.sweepy.dev/guide/dashboard/index.md): The dependency dashboard issue: what it lists, the checkboxes that act on updates, and how to turn it off. - [Auto-merge](https://count-patchula.sweepy.dev/guide/auto-merge/index.md): Write rules that merge update PRs once checks pass, with GitHub's native auto-merge or without it. - Run it - [GitHub Actions](https://count-patchula.sweepy.dev/guide/github-actions/index.md): Run Count Patchula on a schedule with the GitHub Action, for one repository or a whole organization, and the action's inputs. - [Terminal UI](https://count-patchula.sweepy.dev/guide/tui/index.md): Browse a lookup in the terminal with patchula tui: updates, held-back releases, dependencies and warnings. Pick updates to apply locally. - [Applying updates locally](https://count-patchula.sweepy.dev/guide/apply/index.md): Write dependency updates into a local checkout with patchula apply, for scripts, Makefiles and pre-commit hooks. No branches or PRs. - [GitHub App server](https://count-patchula.sweepy.dev/guide/server/index.md): Run patchula serve as a GitHub App: webhooks, scheduled sweeps, acting on checkboxes in seconds, the repository API and remote commands. - Coming from Renovate - [Compatibility matrix](https://count-patchula.sweepy.dev/renovate/compatibility/index.md): Which Renovate managers, datasources, versioning schemes, lockfiles and options Count Patchula supports, and under what names. - [Migrating a config](https://count-patchula.sweepy.dev/renovate/migrating/index.md): Translate a renovate.json into a patchula.pkl by hand: presets that are already defaults, and the equivalent of common rules. - [Departures](https://count-patchula.sweepy.dev/renovate/departures/index.md): Where Count Patchula differs from Renovate in ways a Renovate user would trip over: config, defaults, missing features and PR behaviour. - About - [Benchmarks](https://count-patchula.sweepy.dev/benchmarks/index.md): Count Patchula against Renovate on six large public repositories: lookup time cold and warm, and peak memory. - Reference - [CLI commands](https://count-patchula.sweepy.dev/reference/cli/index.md): Every patchula command, argument and flag, generated from the CLI's usage spec. - [Configuration schema](https://count-patchula.sweepy.dev/reference/configuration/index.md): The complete PatchulaConfig.pkl repository schema, with every field, type and default. - [Settings](https://count-patchula.sweepy.dev/reference/settings/index.md): Operator settings in PatchulaSettings.pkl, shared by the CLI and patchula serve: concurrency, HTTP limits, and the server's triggers, sweeps and allowed installations. - [Environment variables](https://count-patchula.sweepy.dev/reference/environment/index.md): The environment variables patchula reads, the commands that use them, and what each one does. - [JSON report](https://count-patchula.sweepy.dev/reference/report/index.md): The JSON report printed by patchula lookup --json and patchula run --json: repositories, dependencies, updates and lookup failures. - Internals - [Overview](https://count-patchula.sweepy.dev/internals/index.md): How the Count is put together, for people working on him. - [Design](https://count-patchula.sweepy.dev/internals/design/index.md): The goals and principles behind Count Patchula, a replacement for a scheduled Renovate runner: architecture, scope and run modes. - [Engine](https://count-patchula.sweepy.dev/internals/engine/index.md): How the engine reads repositories, looks up updates, builds the report and writes branches. - [SQLite cache](https://count-patchula.sweepy.dev/internals/cache/index.md): How the SQLite cache is laid out: HTTP entries, releases and state, registry tokens, host limits and freshness floors. - [GitHub client](https://count-patchula.sweepy.dev/internals/github-client/index.md): The patchula-github client: shared connection pool, GitHub App tokens, conditional reads, writes, rate limits and pagination. - [Threat model](https://count-patchula.sweepy.dev/internals/threat-model/index.md): Who the Count trusts, what a repository may cause, and which guards follow from that. - [Image SBOM advisories](https://count-patchula.sweepy.dev/internals/image-sboms/index.md): How the Count compares container image SBOMs through OSV.dev to find the advisories a digest update fixes. - [HTTP fixtures](https://count-patchula.sweepy.dev/internals/http-testing/index.md): How Count Patchula's tests replay recorded HTTP cassettes offline, and how to record and check new fixtures. ## Documentation Sets - [Abridged documentation](https://count-patchula.sweepy.dev/llms-small.txt): a compact version of the documentation for Count Patchula, with non-essential content removed - [Complete documentation](https://count-patchula.sweepy.dev/llms-full.txt): the full documentation for Count Patchula - [Guides](https://count-patchula.sweepy.dev/_llms-txt/guides.txt): installing, configuring and running the Count - [Reference](https://count-patchula.sweepy.dev/_llms-txt/reference.txt): the CLI, the configuration and settings schemas, environment variables and the JSON report - [Coming from Renovate](https://count-patchula.sweepy.dev/_llms-txt/coming-from-renovate.txt): the compatibility matrix, migrating a config, and departures from Renovate - [Internals](https://count-patchula.sweepy.dev/_llms-txt/internals.txt): architecture, cache and HTTP test design, for contributors ## Notes - The complete documentation includes all content from the official documentation - The content is automatically generated from the same source as the official documentation ## Optional - [patchula skill](https://raw.githubusercontent.com/sweepies/count-patchula/main/skills/patchula/SKILL.md): the agent skill for using the patchula CLI - [Source code](https://github.com/sweepies/count-patchula)