repokeeper 0.5.0

AI-powered open source maintainer agent

RepoKeeper

AI-powered open source maintainer agent. Reads issues, writes code, opens PRs — 24/7.

# Label an issue agent-todo — RepoKeeper handles the rest
@repokeeper go

Zero config. GitHub-native. ~$0.01 per PR with DeepSeek.

---

Why RepoKeeper?

Open source maintenance is a second job you didn't sign up for. Existing tools help you write code faster — Copilot, Cursor, Codeium. But what about everything else? Triaging issues, bumping dependencies, diagnosing CI, responding to the community?

Copilot helps you write code. RepoKeeper runs your repo while you sleep.

	Copilot / Cursor	RepoKeeper
What it does	Suggests code as you type	Maintains your repo autonomously
How	Inline completion in editor	Reads issues + codebase → opens PRs
When	While you code	24/7 on schedule
Community	No	Monitors, classifies, responds
Dependencies	No	Scans for outdated deps, reports upgrade candidates
CI	No	Diagnoses failures, suggests fixes
Cost	$10–39/month subscription	~$0.01 per PR with DeepSeek
Config	IDE settings	One YAML (or zero)

What It Does

• 🔭 Community Radar — Monitors GitHub issues and discussions for keywords. AI classifies hits. Drafts responses. Notifies you via email, Telegram, or WeChat.
• 🔍 Daily Patrol — Scans 8 ecosystems (pip, npm, Go, Cargo, Bundler, Composer, Maven, Gradle) for outdated deps. Diagnoses CI failures with real job/step data. Auto-fixes CI by opening repair PRs. Finds stale issues. Health score every weekday morning.
• 🤖 Implementation Agent — Reads your codebase + issue → implements → verifies (lint + tests) → pushes branch → opens PR. Streams LLM output in real-time. Tracks token cost. Supports DeepSeek, OpenAI, and Anthropic Claude models.
• 👤 Maintainer Profile — One YAML file describing your code style, tone, PR standards. Or skip it — defaults work.

Adopt in 60 Seconds

Three ways to onboard — pick one:

📋 Copy a workflow

Create .github/workflows/repokeeper.yml in your repo:

mkdir -p .github/workflows
curl -fsSLo .github/workflows/repokeeper.yml \
  https://raw.githubusercontent.com/shenxianpeng/repokeeper/main/src/repokeeper/templates/workflows/repokeeper.yml

Or copy the content below:

name: RepoKeeper Implementation Agent

on:
  issue_comment:
    types: [created]
  issues:
    types: [labeled]

jobs:
  repokeeper:
    runs-on: ubuntu-latest
    if: |
      (
        github.event_name == 'issue_comment' &&
        !github.event.issue.pull_request &&
        contains(github.event.comment.body, '@repokeeper go') &&
        (
          github.event.comment.author_association == 'OWNER' ||
          github.event.comment.author_association == 'MEMBER' ||
          github.event.comment.author_association == 'COLLABORATOR'
        )
      ) ||
      (
        github.event_name == 'issues' &&
        github.event.label.name == 'agent-todo'
      )
    permissions:
      contents: write
      issues: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

      - uses: actions/setup-python@v6
        with:
          python-version: '3.10'

      - name: Install RepoKeeper
        run: pip install repokeeper

      - name: Run RepoKeeper Agent
        env:
          PYTHONUNBUFFERED: 1
          DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
          REPOKEEPER_GITHUB_TOKEN: ${{ secrets.REPOKEEPER_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}
          GITHUB_REPOSITORY: ${{ github.repository }}
          ISSUE_NUMBER: ${{ github.event.issue.number }}
          LLM_BASE_URL: ${{ secrets.LLM_BASE_URL || 'https://api.deepseek.com' }}
        run: repokeeper agent --repo "$GITHUB_REPOSITORY" --issue "$ISSUE_NUMBER"

Then add your API key: Settings → Secrets → Actions → New secret: DEEPSEEK_API_KEY = sk-...

Before pushing, run the setup check:

repokeeper doctor --repo owner/repo

doctor verifies the profile, workflow triggers, workflow permissions, token environment, LLM key, and repository slug. Fix anything marked missing, then push the workflow.

Want Radar & Patrol too? Copy radar.yml and patrol.yml into the same .github/workflows/ folder.

🖥️ CLI

pip install repokeeper
repokeeper init --all-workflows   # profile + all 3 workflows
repokeeper init --minimal         # profile + agent workflow only
repokeeper doctor --repo owner/repo

🤖 Ask AI

Paste this into any AI coding agent (Copilot Chat, Claude Code, Cursor, Windsurf, pi, etc.):

Add RepoKeeper to this repository. Create .github/workflows/repokeeper.yml with the Implementation Agent workflow from github.com/shenxianpeng/repokeeper — trigger on issue comments (@repokeeper go) and labels (agent-todo). Use pip install repokeeper in the workflow. Then tell me to add a DEEPSEEK_API_KEY secret in GitHub Actions settings.

Trigger the agent

Label any issue agent-todo — or comment @repokeeper go.

---

Install (optional CLI)

pip install repokeeper

repokeeper init             # Create a profile
repokeeper init --minimal   # Create a profile + agent workflow
repokeeper doctor --repo owner/repo
repokeeper radar --repo owner/repo
repokeeper patrol --repo owner/repo --summary
repokeeper agent --repo owner/repo --issue 42

---

Documentation

Full docs at shenxianpeng.github.io/repokeeper

Guide
Quick Start	5-minute setup
Security	Permissions, tokens, and automation boundaries
Community Radar	Monitor your community
Daily Patrol	Automated health checks
Implementation Agent	AI-powered PRs
Maintainer Profile	Full config reference

Contributing

Contributions are welcome, especially documentation examples, setup diagnostics, tests, and safety improvements. See CONTRIBUTING.md before opening a pull request.

Safety Model

RepoKeeper creates reviewable pull requests; it does not merge them for you. The default workflow limits write access to branches, issue comments, and pull requests, and the agent blocks edits under .github/workflows/. See the Security guide before enabling it on sensitive repositories.

---

License

MIT © Xianpeng Shen