AutoMaintain

Config generator

Set your options, then download one workflow file. Commit it to your repo and AutoMaintain handles the rest — scripts are fetched automatically, no PAT required.

issue/discussion opened
→
agent reasons
→
comments run instantly
→
code edits need lock

Source

Model

Trust gate

Actions the agent is allowed to plan

Comment on issues / reply to PRssafe
Always available — this is how the agent talks to people.
Add / remove labelssafe
Triage labeling, always available.
Mark & close as duplicatesafe
Closes with a comment linking the original issue.
Close as not planned / wontfixsafe
Closes with an explanation, no repo changes.
Close as completedsafe
Routine maintenance — not gated.
Create branches & commit file changessafe
Not gated for ordinary files. Always on a new automaintain/* branch. Large deletions (>200KB or >5 files) and any edit under .github/workflows/ stay gated regardless.
Open pull requestssafe
Routine maintenance — not gated.
Merge pull requestssafe
Routine maintenance — not gated by default. Uncheck if you'd rather require the trust label for merges too.
Review pull requests (approve / request changes / comment)safe
AI reviews PR diffs, posts inline comments, and approves or requests changes. Use with auto-merge for fully autonomous maintenance.
Respond to discussions (comment & mark as answered)safe
Answers questions in GitHub Discussions with full markdown formatting. Can mark discussions as answered.
Flag suspicious requestsalways on
Backdoors, mass wipes, credential exfiltration — refused and flagged for owner review regardless of trust label. Not optional.

Tools available to the agent

Web search
Lightweight no-key search, for checking docs/error messages before acting.
Read / list / grep repo files
Read-only inspection of the current checkout.
Run shell commands
Execute git, npm, and other commands. 30s timeout, dangerous commands blocked.
Git history & branches
View file history, diffs between refs, list branches.
Notes & context
Save and read notes in .automaintain/ for persistent project context.
Sub-agents
Spawn parallel agents for research and analysis tasks.

Terms of Use

AutoMaintain Terms of Use

By using AutoMaintain, you agree to the following:

  • Choose your trust level — require manual review or grant AutoMaintain permission to auto-merge changes.
  • You are responsible for any damage caused by AI-generated code.
  • Display the AutoMaintain badge in your repository's README: <a href="https://github.com/StuffzEZ/AutoMaintain"><img src="https://stuffzez.github.io/AutoMaintain/badge.png" alt="AutoMaintain" width="120"></a>
  • AI output may contain errors including bugs, security vulnerabilities, or incorrect logic.
  • The Software is provided "AS IS" without warranty of any kind.
  • You are responsible for securing your OpenRouter API key.
  • We are not liable for any loss of data, revenue, or business resulting from use of AutoMaintain.

For full terms, see TERMS.md.

Setup

  1. Add repo secret OPENROUTER_API_KEY (Settings → Secrets and variables → Actions). Free key at openrouter.ai/keys, no card needed.
  2. Settings → Actions → General → Workflow permissions → Read and write permissions.
  3. Commit the generated automaintain.yml to .github/workflows/. That's the only file you need.
  4. Open an issue or PR. The agent will triage it and, if changes are needed, ask you to add the trust label.
  5. Add the trust label when you're happy to let it act — it'll pick the request up on the next comment or you can comment !retry.