Set it up once.
Let it handle the backlog.
A Python harness that acts as a dedicated AI co-maintainer — always on, credentials never exposed, no babysitting required.
Get started in 30 minutesWhat Foreman handles
-
Issue triage and labeling
- Reads new issues, applies labels, and responds or escalates based on your configured rules.
-
Always-on GitHub polling
- Monitors every configured repository on a set interval. No webhooks, no infrastructure to maintain.
-
Automated responses
- Posts replies and closes stale issues under your bot's GitHub identity, on your schedule.
-
Credential-safe agent isolation
- Agents produce decisions; the harness owns every GitHub API call. Your token never enters an agent container.
Running in under 30 minutes
pip install foreman
foreman init config.yaml
foreman start
Documentation
Get Started
Install Foreman and configure your first repository in under 30 minutes.
How It Works
The security model, ownership boundaries, and design decisions behind Foreman.
How-To Guides
Recipes for common configurations and tasks.
Reference
Configuration, CLI, agent protocol, and API documentation.
Developer Guide
Extending Foreman and contributing to the project.